データベース¶

データベース管理コマンドラインツール¶

The database management command-line tool is called neutron-db-manage. Pass the --help option to the tool for usage information.

このツールでは、オプションの後にコマンドが続きます。

$ neutron-db-manage <options> <commands>

このツールでは、 OpenStack 環境の設定ファイル neutron.conf で指定されるデータベース接続の文字列オプションが必要です。 /etc/neutron/neutron.conf が存在する場合は、自動的にこのファイルから設定を読み込みます。設定ファイルが別の場所にある場合は、以下のコマンドを使用します。

$ neutron-db-manage --config-file /path/to/neutron.conf <commands>

Multiple --config-file options can be passed if needed.

Instead of reading the DB connection from the configuration file(s), you can use the --database-connection option:

$ neutron-db-manage --database-connection
  mysql+pymysql://root:secret@127.0.0.1/neutron?charset=utf8 <commands>

The branches, current, and history commands all accept a --verbose option, which, when passed, will instruct neutron-db-manage to display more verbose output for the specified command:

$ neutron-db-manage current --verbose

新規のデプロイメントでは、空のデータベースから始め、以下のコマンドを使って最新のデータベースバージョンまでアップグレードします。

$ neutron-db-manage upgrade heads

新しいバージョンの neutron サーバーのインストール後は、以下のコマンドを使ってデータベースをアップグレードします。

$ neutron-db-manage upgrade heads

既存のデプロイメントでは、以下のコマンドを使って現在のデータベースのバージョンを確認します。

$ neutron-db-manage current

拡張の移行ルールを適用するには、以下のコマンドを使用します。

$ neutron-db-manage upgrade --expand

拡張以外の移行ルールを適用するには、以下のコマンドを使用します。

$ neutron-db-manage upgrade --contract

適用待ちの contract (縮小) 移行ルールがあり、オフラインでの移行が必要かを確認するには、以下のコマンドを実行します。

$ neutron-db-manage has_offline_migrations

データベースを直接操作せず、代わりにコマンドスクリプトを生成するには、以下のコマンドを実行します。

$ neutron-db-manage upgrade heads --sql

.. note::

   The `--sql` option causes the command to generate a script.  The script
   can be run later (online or offline), perhaps after verifying and/or
   modifying it.

指定したバージョン間の移行を行うには、以下のコマンドを実行します。

$ neutron-db-manage upgrade <start version>:<end version>

データベースのアップグレードを少しずつ行うには、以下のコマンドを使用します。

$ neutron-db-manage upgrade --delta <# of revs>

To look for differences between the schema generated by the upgrade command and the schema defined by the models, use the revision --autogenerate command:

neutron-db-manage revision -m REVISION_DESCRIPTION --autogenerate