概要
admintoolsコマンドのコマンドラインツールを使用することで、コマンド実行のみでデータベースを作成することができます。CUIによる対話形式の操作が必要ないため、人的な操作ミスの心配がなく、またシェルスクリプト等に組み込むことが可能です。
構文
作成
|
1 |
admintools -t create_db -d データベース名 -p パスワード |
削除
|
1 |
admintools -t drop_db -d データベース名 |
基本的な実行例
データベースの作成
1台構成の場合
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
--sampleというデータベースを作成 $ admintools -t create_db -d sample -p sample -s 10.0.0.132 Database with 1 or 2 nodes cannot be k-safe and it may lose data if it crashes Distributing changes to cluster. Creating database sample Starting bootstrap node v_sample_node0001 (10.0.0.132) Starting nodes: v_sample_node0001 (10.0.0.132) Starting Vertica on all nodes. Please wait, databases with a large catalog may take a while to initialize. Node Status: v_sample_node0001: (DOWN) Node Status: v_sample_node0001: (DOWN) Node Status: v_sample_node0001: (DOWN) Node Status: v_sample_node0001: (DOWN) Node Status: v_sample_node0001: (UP) Installing kafka package Success: package kafka installed Installing voltagesecure package Success: package voltagesecure installed Installing MachineLearning package Success: package MachineLearning installed Installing AWS package Success: package AWS installed Installing VFunctions package Success: package VFunctions installed Installing ParquetExport package Success: package ParquetExport installed Installing flextable package Success: package flextable installed Installing approximate package Success: package approximate installed Installing place package Success: package place installed Installing txtindex package Success: package txtindex installed Installing logsearch package Success: package logsearch installed Database creation SQL tasks completed successfully. Database sample created successfully. |
3台構成の場合
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 |
--sample2というデータベースを作成 $ admintools -t create_db -d sample2 -p sample2 -s 10.0.0.132,10.0.0.133,10.0.0.134 Distributing changes to cluster. Creating database sample2 Starting bootstrap node v_sample2_node0001 (10.0.0.132) Starting nodes: v_sample2_node0001 (10.0.0.132) Starting Vertica on all nodes. Please wait, databases with a large catalog may take a while to initialize. Node Status: v_sample2_node0001: (DOWN) Node Status: v_sample2_node0001: (DOWN) Node Status: v_sample2_node0001: (DOWN) Node Status: v_sample2_node0001: (DOWN) Node Status: v_sample2_node0001: (UP) Creating database nodes Creating node v_sample2_node0002 (host 10.0.0.133) Creating node v_sample2_node0003 (host 10.0.0.134) Generating new configuration information Stopping single node db before adding additional nodes. Database shutdown complete Starting all nodes Start hosts = ['10.0.0.132', '10.0.0.133', '10.0.0.134'] Starting nodes: v_sample2_node0001 (10.0.0.132) v_sample2_node0002 (10.0.0.133) v_sample2_node0003 (10.0.0.134) Starting Vertica on all nodes. Please wait, databases with a large catalog may take a while to initialize. Node Status: v_sample2_node0001: (DOWN) v_sample2_node0002: (DOWN) v_sample2_node0003: (DOWN) Node Status: v_sample2_node0001: (DOWN) v_sample2_node0002: (DOWN) v_sample2_node0003: (DOWN) Node Status: v_sample2_node0001: (DOWN) v_sample2_node0002: (DOWN) v_sample2_node0003: (DOWN) Node Status: v_sample2_node0001: (INITIALIZING) v_sample2_node0002: (DOWN) v_sample2_node0003: (INITIALIZING) Node Status: v_sample2_node0001: (UP) v_sample2_node0002: (UP) v_sample2_node0003: (UP) Installing kafka package Success: package kafka installed Installing voltagesecure package Success: package voltagesecure installed Installing MachineLearning package Success: package MachineLearning installed Installing AWS package Success: package AWS installed Installing VFunctions package Success: package VFunctions installed Installing ParquetExport package Success: package ParquetExport installed Installing flextable package Success: package flextable installed Installing approximate package Success: package approximate installed Installing place package Success: package place installed Installing txtindex package Success: package txtindex installed Installing logsearch package Success: package logsearch installed Database creation SQL tasks completed successfully. Database sample2 created successfully. |
データベースの削除
|
1 2 3 |
--testというデータベースを削除します。 $ admintools -t drop_db -d test Database test dropped |
注意点
・データベースの作成時、既存のデータベースは全て停止している必要があります。一つのサーバ上で同時に起動できるVerticaデータベースは一つのみであるためです。
停止していない場合、以下のエラーが発生します。
|
1 2 3 4 5 6 7 |
$ admintools -t create_db -d sample -p sample -s 10.0.0.132 Database with 1 or 2 nodes cannot be k-safe and it may lose data if it crashes Distributing changes to cluster. ERROR: running database 'test' already uses port 5433 ERROR: you must first stop database 'test' before creating a new database Error: ERROR: running database 'test' already uses port 5433 ERROR: you must first stop database 'test' before creating a new database |
・データベースの削除時、削除対象のデータベースは停止している必要があります。
停止していない場合、以下のエラーが発生します。
|
1 2 3 |
$ admintools -t drop_db -d sample2 Database sample2 is currently running and must be stopped before it can be dropped. |
オプション
| オプション名 | 内容 |
|---|---|
| -h --help | このヘルプメッセージを表示して終了します |
| -D ディレクトリ --data_path=ディレクトリ | データディレクトリのパス |
| -c ディレクトリ --catalog_path=ディレクトリ | カタログディレクトリのパス |
| -d DB名 --database=DB名 | 作成するデータベースの名前 ※省略不可 |
| -l ライセンスファイル --license=ライセンスファイル | データベースライセンス |
| -p DBのパスワード --password=DBのパスワード | データベースパスワード |
| -P POLICY, --policy=POLICY | データベース再起動ポリシー |
| -s ホスト --hosts=ホスト | データベースにクラスタを構成するノードのIPアドレス ※複数記述する場合、カンマ区切りで指定 |
| --shard-count=シャード数 | データベース内のシャードの数 ※Eonモードのみ |
| --communal-storage-location=COMMUNAL_STORAGE_LOCATION | 共有ストレージの場所 ※Eonモードのみ |
| -x COMMUNAL_STORAGE_PARAMS --communal-storage-params=COMMUNAL_STORAGE_PARAMS | 共有ストレージパラメータファイルの場所 ※Eonモードのみ |
| --depot-path=DEPOT_PATH | デポディレクトリへのパス ※Eonモードのみ |
| --depot-size=DEPOT_SIZE | デポのサイズ ※Eonモードのみ |
| --force-cleanup-on-failure | コマンドの失敗時、既に作成されたディレクトリを強制的に削除 |
| --force-removal-at-creation | データベースを作成する前に既存のディレクトリを強制的に削除 |
参考情報
Writing Administration Tools Scriptshttps://www.vertica.com/docs/9.3.x/HTML/Content/Authoring/AdministratorsGuide/AdminTools/WritingAdministrationToolsScripts.htm
コマンドラインによるadmintoolsの操作方法
http://vertica-tech.ashisuto.co.jp/admintools_commandline/
データベースの停止、起動方法（admintools）
http://vertica-tech.ashisuto.co.jp/stop_start_database_admintools/
検証バージョンについて
この記事の内容はVertica 9.3で確認しています。更新履歴
2020/4/2 本記事を公開- 投稿タグ
- admintools, コマンドライン
