PolarDB:PolarPlus

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

PolarPlus は圧縮パッケージとして提供され、インストールは不要です。Linux で使用するには、パッケージをダウンロードして解凍します。解凍後のディレクトリ構造は以下のとおりです。polarplus ファイルが実行可能ファイルです。polarplus_release/ ディレクトリのパスをシステムの PATH に追加すると、polarplus コマンドを実行できます。

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

PolarPlus の使用方法

概要

PolarPlus は、PolarDB 用のコマンドラインユーザーインターフェイスユーティリティです。SQL コマンド、PolarPlus コマンド、PL/SQL 匿名ブロック、関数、およびストアドプロシージャをサポートしています。このツールは、以下の機能を提供します。

• 特定のデータベースオブジェクトのクエリ

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

• SQL コマンドの出力フォーマット

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

• オペレーティングシステムコマンドの実行

• 出力の記録

ネイティブツールとの違い

PolarPlus は PolarDB 向けに設計されており、Oracle SQLPlus ツールの一般的な機能をサポートしています。

PolarPlus の設定

1. wget コマンドを使用して PolarPlus をダウンロードして解凍します。ダウンロードリンクについては、「クライアントのダウンロード」を参照してください。

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

3. export base="{pwd}/polarplus" を変更し、{pwd} を polarplus ディレクトリの絶対パスに置き換えます。

4. サーバーで次のコマンドを使用して PolarPlus を起動します：

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

   パラメーター	説明
   -S[ILENT ]	このパラメーターを指定すると、PolarPlus ログインバナーとすべてのプロンプトが非表示になります。
   login	データベースサーバーとデータベースへの接続に使用するログイン情報です。 ログイン情報は次の形式を使用します： username[/password][@{connectstring | variable } ] 詳細については、「ログイン情報」をご参照ください。 variable は、login.sql ファイルで定義されている変数です。このファイルにはデータベース接続文字列が含まれています。
   /NOLOG	/NOLOG を指定して PolarPlus を起動すると、PolarPlus の起動時にデータベース接続は確立されません。このモードではデータベースに接続されないため、SQL コマンドや PolarPlus コマンドは使用できません。 説明 /NOLOG オプションで PolarPlus を起動した後、CONNECT コマンドを使用してデータベースに接続できます。
   scriptfile[.ext ]	scriptfile は、現在の作業ディレクトリ内のファイル名です。このファイルには、PolarPlus の起動後に自動的に実行される SQL コマンドと PolarPlus コマンドが含まれています。 .ext はファイル名拡張子です。ファイル名拡張子が sql の場合、スクリプトファイルを指定するときに .sql 拡張子を省略できます。スクリプトファイルを作成するときは、ファイル名に拡張子を付けてください。そうしないと、PolarPlus はファイルにアクセスできません。 説明 PolarPlus は、拡張子が指定されていないファイル名に対して常に .sql 拡張子を使用します。

   表 1. ログイン情報

   パラメーター	説明
   username	データベースへの接続に使用するデータベースユーザー名です。
   password	指定されたユーザー名に関連付けられたパスワードです。
   connectstring	次の形式のデータベース接続文字列です： host[:port][/dbname][?ssl={true | false}] host は、データベースサーバーのホスト名または IP アドレスです。 説明 connectstring、variable、または NOLOG が指定されていない場合、ホストのデフォルト値はローカルホストです。 IPv6 アドレスを使用して接続する場合は、IP アドレスを角括弧で囲む必要があります。 IPv6 アドレスを使用した接続の例を次に示します： polarplus polardb/password@[fe80::20c:29ff:fe7c:78b2]:5444/polardb port は、データベースサーバーで接続を受け付けるポート番号です。 説明 指定されていない場合、デフォルト値は 5444 です。 dbname は、接続先のデータベース名です。 説明 指定されていない場合、デフォルト値は polardb です。 SSL 接続が必要な場合は、接続文字列に ?ssl=true パラメーターを含めます。接続文字列には host:port を含める必要があります。SSL パラメーターが指定されていない場合、デフォルト値は false です。

   接続例を次に示します：

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

   説明

   PolarPlus は、PolarDB for PostgreSQL (Compatible with Oracle) のバージョン 1.0 への接続専用です。PolarDB for PostgreSQL (Compatible with Oracle) のバージョン 2.0 に接続するには、PolarPlus2 をダウンロードしてください。そのディレクトリ構造と使用方法は PolarPlus と同様です。ディレクトリとコマンドで polarplus を polarplus2 に置き換えるだけです。