PolarDB:PolarPlus

PolarPlus クライアントのダウンロード

PolarPlus では、無料のインストールパッケージが用意されています。 インストールパッケージを Linux で使用するには、ダウンロード後に展開します。 以下のコードに、展開後の PolarPlus ディレクトリの構造を示します。 polarplus ファイルは実行ファイルです。 polarplus_release/ ディレクトリのパスをシステム変数 PATH に追加すると、polarplus コマンドを実行できます。

polarplus_release
├── polarplus -> ./polarplus.sh
├── polarplus.sh
├── polarplus.jar
├── login.sql
├── etc
│ └── sysconfig
├── help
└── lib

PolarPlus の使用

PolarPlus では、PolarDB 用の CLI が用意されています。 PolarPlus では、SQL 文、ストアドプロシージャ言語 (SPL) 匿名ブロック、PolarPlus コマンドがサポートされています。

PolarPlus では、以下の操作を実行できます。

• 指定したデータベースオブジェクトのクエリ。

• ストアドプロシージャの実行。

• SQL 文の出力の整形。

• バッチ処理スクリプトの実行。

• OS コマンドの実行。

• レコードの出力。

PolarPlus をダウンロードして設定するには、以下の手順を実行します。

1. wget コマンドを実行して、「PolarPlusクライアントをダウンロードする」で指定されたリンクから PolarPlus パッケージをダウンロードします。 PolarPlus パッケージを展開します。

2. bin ディレクトリに移動します。

3. polarplus.sh ファイルを開きます。

4. export base="{pwd}/polarplus" line: Replace {pwd} を polarplus ファイルの絶対パスに変更します。

5. PolarDB データベースに接続するサーバーで、以下のコマンドを実行して PolarPlus を起動します。

   polarplus [ -S[ILENT ] ] [ login | /NOLOG ] [ @scriptfile[.ext ] ]

   パラメーター	説明
   -S[ILENT ]	このパラメーターを設定すると、PolarPlus を使用してデータベースに接続する際、ログインバナーやログオン関連のメッセージは表示されません。
   login	データベースサーバーとデータベースへの接続に使用されるログイン情報です。 このパラメーターの値は、以下の形式で指定する必要があります。 username[/password][@{connectstring | variable } ] 詳細については、「ログインパラメーター」をご参照ください。 変数パラメーターは、login.sql ファイルで定義されている変数です。 login.sql ファイルには、データベースの接続文字列が含まれています。
   /NOLOG	/NOLOG を指定した場合、PolarPlus の起動時にデータベースへの接続が作成されません。 データベースに接続して SQL 文を実行したり、PolarPlus コマンドを実行したりする場合は、このオプションを指定しないでください。 説明 PolarPlus を起動する際にこのオプションを指定した場合は、CONNECT コマンドを実行してデータベースに接続します。
   scriptfile[.ext ]	scriptfile パラメーターには、現在の作業ディレクトリに格納されているファイルの名前を指定します。 このファイルには、自動的に実行される SQL 文と、PolarPlus の起動後に自動的に実行される PolarPlus コマンドが含まれています。 specifies the file extension. スクリプトファイルのファイル拡張子が .sql の場合、スクリプトファイルを指定する際にファイル拡張子を省略できます。 スクリプトファイルを作成するときは、ファイル名を <file name>.<file extension> の形式で指定します。 この形式以外の場合、PolarPlus はファイルにアクセスできません。 説明 ファイル名にファイル拡張子サフィックスが付加されていないファイルの場合、PolarPlus はそのファイルを .sql ファイルとして処理します。

   表 1. ログインパラメーター

   パラメーター	説明
   username	データベースへの接続に使用されるユーザー名です。
   password	データベースへの接続に使用されるパスワードです。
   connectstring	データベースの接続文字列です。 接続文字列は、以下の形式で指定する必要があります。 host[:port][/dbname][?ssl={true | false}] host パラメーターには、データベースサーバーのホスト名または IP アドレスを指定します。 説明 connectstring、variable および NOLOG のいずれも設定されていない場合、既定のホストはオンプレミスホストです。 Internet Protocol version 6 (IPv6) アドレスを使用してデータベースに接続する場合は、IP アドレスを角括弧 ([]) 内に配置する必要があります。 以下の例で、IPv6 アドレスを使用してデータベースに接続する方法を示します。 polarplus polardb/password@[fe80::20c:29ff:fe7c:78b2]:5444/polardb port パラメーターは、データベースサーバーが接続要求を受信するために使用するポートを指定します。 説明 このパラメーターが設定されなかった場合、デフォルトのポート 5444 が使用されます。 dbname パラメーターは、接続するデータベースの名前を指定します。 説明 このパラメーターが設定されなかった場合、デフォルト値 (polardb) が使用されます。 SSL 接続を作成する場合は、接続文字列に ?ssl = true および host:port を指定する必要があります。 指定されていない場合、SSL 接続は確立できません。

   以下の例に、PolarPlus を使用して PolarDB データベースに接続する方法を示します。

   polarplus  polardb/password@pc-bp1zxxxxxxxxxxx.o.polardb.rds.aliyuncs.com:1521/polardb

   説明

   PolarPlus は、PolarDB for PostgreSQL (Oracle 互換) 1.0 クラスターに接続するためにのみ使用されます。 PolarDB for PostgreSQL (Oracle 互換) 2.0 クラスターに接続するには、PolarPlus2 をダウンロードする必要があります。 PolarPlus2 のディレクトリ構造と使用法は、PolarPlus と同様です。 ディレクトリとコマンドの polarplus のみ、polarplus2 に置き換えられます。