1 はじめに
1.1 新機能
1.2 このガイドで使用される表記規則
2.1.1 インストールの前提条件
2.1.2 RPMインストールの実行
2.1.3 グラフィカルインストーラーの使用
2.2 EDB * Plusの起動
2.3.1 Advanced ServerでのSSLの構成
2.3.2 EDB * PlusクライアントのSSLの構成
2.4 コマンドの要約
2.4.1 承諾
2.4.2 追加
2.4.3 CHANGE
2.4.4 クリア
2.4.5 カラム
2.4.6 CONNECT
2.4.7 定義
2.4.8 DEL
2.4.9 記述
2.4.10 切断
2.4.11 編集
2.4.12 EXECUTE
2.4.13 EXIT
2.4.14 GET
2.4.15 ヘルプ
2.4.16 ホスト
2.4.17 入力
2.4.18 リスト
2.4.19 パスワード
2.4.20 一時停止
2.4.21 プロンプト
2.4.22 QUIT
2.4.23 備考
2.4.24 保存
2.4.25 セット
2.4.26 ショー
2.4.27 スプール
2.4.28 開始
2.4.29未定義
2.4.30 WHENEVER SQLERROR
1 はじめにこのガイドでは、 EDB * Plusを使用して Advanced Serverデータベースに接続する方法について説明します。 EDB * Plusは 、あなたができるようにするSQLコマンドを受け入れるEDB PostgresのAdvanced Serverにコマンドラインユーザーインタフェースを提供します。
1.1 新機能
1.2 このガイドで使用される表記規則次の説明では、 用語は、言語キーワード、ユーザー指定の値、リテラルなどの単語または単語グループを指します。用語の正確な意味は、使用されるコンテキストによって異なります。
EDB * Plusは、 EDB Postgres Advanced Serverにコマンドラインユーザーインターフェイスを提供するユーティリティプログラムです。 EDB * Plusは、 SQLコマンド、 SPL無名ブロック、およびEDB * Plusコマンドを受け入れます。EDB * PlusコマンドはOracle SQL * Plusコマンドと互換性があり、次のようなさまざまな機能を提供します。
2.1.1 インストールの前提条件EDB * Plusをインストールする前に 、最初にJava（バージョン1.7以降）をインストールする必要があります。 Linuxシステムでは、yumパッケージマネージャーを使用してJavaをインストールできます。ターミナルウィンドウを開き、スーパーユーザー権限を引き受けて、次のように入力します。2.1.2 RPMインストールの実行パッケージは edbas10リポジトリにあります。 EDB * Plusをインストールするには、 edbas10リポジトリを作成して有効にする必要があります。リポジトリを作成するパッケージの名前はedb - repoです。パッケージは、次のEnterpriseDBから入手できます。EDB * PlusのRPMインストールを実行した後、EDB * PlusがJavaインストールを見つけることができる環境変数の値を設定する必要があります。次のコマンドを使用して、変数値を設定します。デフォルトでは、 pg _ hbaです。 RPMインストーラーのconfファイルは、IDENT認証を強制します。 EDB * Plusを呼び出す前に、 pg _ hba変更する必要があります。 confファイル、認証方法をIDENT以外の形式に変更する（およびサーバーを再起動する）か、次の手順を実行してIDENTサーバーにアクセスできるようにします。identdサーバーがインストールされ、実行されていることを確認する必要があります。次のコマンドを呼び出して、yumパッケージマネージャーを使用してidentdサーバーをインストールidentdます。EDB * Plusを呼び出す前に、Advanced Serverサービスを再起動する必要があります。 Advanced Serverサービスの制御の詳細については、 EDB Postgres Advanced Serverインストールガイドを 参照してください 。2.1.3 グラフィカルインストーラーの使用
[ Installation Directoryフィールドを使用して 、EDB * Plusソフトウェアをインストールするディレクトリを指定します（図2.2を参照）。次に、 Nextをクリックして続行します。
EDB Postgres Advanced Server Installation Detailsウィンドウ（図2.3を参照）のフィールドを使用して 、Advanced Serverホストの場所を特定します。
Ready to Installウィンドウを（図2.4を参照）インストーラがシステムにEDB * Plusをインストールするために必要なすべての情報を持っているときに通知します。 [ Nextをクリックして、EDB * Plusをインストールします。
2.2 EDB * Plusの起動EDB * Plusコマンドラインを開くには、 Start Applications （またはStart ）メニューから[ Advanced Server ]メニュー、[ SQL Command LineのRun ]メニューに移動し、[ EDB*Plus ]オプションを選択します。次のコマンドを使用して、オペレーティングシステムのコマンドラインからEDB * Plusを呼び出すこともできます。指定した場合、 EDB * Plusサインオンバナーはすべてのプロンプトとともに抑制されます。データベースサーバーおよびデータベースに接続するためのログイン情報。 login形式は次のとおりです。 （ログイン情報内に空白があってはなりません。）usernameは、データベースに接続するためのデータベースユーザー名です。passwordは、指定されたusername関連付けられたパスワードです。 passwordが提供されていないが、認証にパスワードが必要な場合、パスワードファイルが使用可能であれば使用されます。パスワードファイルがないか、一致する接続パラメーターを持つパスワードファイルにエントリがない場合、 EDB * Plusはパスワードの入力を求めます。パスワードファイルと認証方法の使用の詳細については、セクション2.4.6を参照してください。connectstringは、次の形式のデータベース接続文字列です。hostは、データベースサーバーが存在するホスト名またはIPアドレスです。 @ connectstringも@ variableも/NOLOGも指定されていない場合、デフォルトのホストはlocalhostであると想定されます。 portは、データベースサーバーで接続を受信するポート番号です。指定しない場合、デフォルトは5444.でdbnameに接続するデータベースの名前です。指定しない場合、デフォルトはedbです。 インターネットプロトコルバージョン6 （IPv6）がIPv4の代わりに接続に使用される場合、IPアドレスは角括弧で囲まれている必要があります（つまり、 [ ipv6_address ] ）。以下は、IPv6接続を使用した例です。データベースサーバーの pg_hba.confファイルには、IPv6接続の適切なエントリが含まれている必要があります。次の例は、すべてのアドレスを許可するエントリを示しています。詳細について pg_hba.confファイル、でPostgreSQLのコアのドキュメントを参照してください。SSL接続が必要な場合は、接続文字列に?ssl=trueパラメーターを含めます。このような場合、接続文字列には/ dbname有無にかかわらず、最小限host : port含める必要がありdbname 。 sslパラメーターが指定されていない場合、デフォルトはfalseです。 SSL接続の設定手順については、セクション2.3を参照してください。variableは、データベース接続文字列を含むlogin.sqlファイルで定義された変数です。 login.sqlファイルは、 Advanced Serverホームディレクトリのedbplusサブディレクトリにあります 。/NOLOGを指定して、データベース接続を確立せずにEDB * Plusを起動します。データベース接続を必要とするSQLコマンドおよびEDB * Plusコマンドは、このモードでは使用できません。 /NOLOGオプションを指定してEDB * Plusを起動した後、 CONNECTコマンドを/NOLOGてデータベースに接続できます。scriptfile自動的にEDB * Plusの起動後に実行されるSQLおよび/またはEDB * Plusのコマンドを含む、現在の作業ディレクトリに存在するファイルの名前です。 extはファイル名拡張子です。ファイル名拡張子がsql場合、 scriptfile指定するときに.sql拡張子を省略できscriptfile 。スクリプトファイルを作成するときは、必ず拡張子を付けてファイルに名前を付けてください。そうしないと、 EDB * Plusからアクセスできなくなります。 （ EDB * Plusは、拡張子なしで指定されたファイル名で.sql拡張子を常に想定します。）次の例では 、 password enterprisedb ユーザー enterprisedbが、ポート5444のローカルホスト上のデータベースサーバーで実行されているデータベースedbに接続しています。
Java トラストストアは、Javaクライアント（EDB * Plus）がSSL接続を開始するサーバーの信頼性を検証するために使用する認証局（CA）証明書を含むファイルです。Java キーストアは、秘密鍵と公開鍵、およびそれらに対応する証明書を含むファイルです。キーストアは、EDB * Plus接続に使用されるサーバーへのクライアント認証に必要です。
2.3.1 Advanced ServerでのSSLの構成ステップ1：証明書署名要求（CSR）を作成します。注：証明書を作成する場合、共通名フィールドに指定する値（この例ではCN=enterprisedbとして指定）は、EDB * Plusへの接続時に指定するデータベースユーザー名である必要があります。さらに、 pg_ident.confファイルで定義されているユーザー名マップを使用して、共通名とデータベースユーザー名の柔軟性を高めることができます。手順8および9では、ユーザー名マップの使用について説明します。ステップ2：自己署名証明書を生成します。ステップ4：現在冗長な証明書署名要求（ server.csr ）を削除します。手順5：証明書と秘密キーファイルをAdvanced Serverデータディレクトリ（ /opt/edb/as10/data ）に移動またはコピーします。ステップ6：証明書ファイルと秘密鍵ファイルにファイルの所有権と許可を設定します。所有権を 、データベースサーバーのdataサブディレクトリを所有するオペレーティングシステムアカウントに設定します。所有者以外の他のグループまたはアカウントがこれらのファイルにアクセスできないように、アクセス許可を設定します。ステップ7： postgresql.confファイルで、次の変更を行います。ステップ8： pg_hba.confファイルを変更して、EDB * PlusがSSL接続を行う目的のデータベースでSSLの使用を有効にします。認証方法は 、証明書の共通名（この例ではenterprisedb ）を使用して認証が実行されるクライアントからのSSL証明書を要求するために、オプションclientcert=1でcert 設定されます。map=sslusersオプションは、マッピングという名前のように指定しsslusersで定義されているpg_ident.confファイルが認証に使用されます。このマッピングにより、証明書からの共通名と接続を試行するデータベースユーザー名がpg_ident.confファイルにリストされているSYSTEM-USERNAME/PG-USERNAMEペアと一致する場合、データベースへの接続が許可されます。ステップ9：以下は、 map=sslusersオプションによるpg_hba.confファイルに関連するpg_ident.confファイル内のユーザー名マップを示しています。これらのユーザー名マップを使用すると、EDB * Plusに接続するときにデータベースユーザー名edbuser 、 postgres 、またはenterprisedbを指定できます。手順10：構成ファイルに変更を加えた後、データベースサーバーを再起動します。
2.3.2 EDB * PlusクライアントのSSLの構成手順1：データベースサーバーのdataサブディレクトリにあるserver.crtおよびserver.keyファイルを使用して、これらのファイルのコピーを作成し、EDB * Plusを実行するホストに移動します。これらのファイルを目的のディレクトリに保存し、次の手順で生成される信頼できる証明書とキーストアファイルを含めます。推奨される場所は、 EDB * Plusを呼び出すホームユーザーアカウントの下に.postgresqlサブディレクトリを作成することです。したがって、これらのファイルは、EDB * Plusを実行するユーザーアカウントの~/.postgresqlディレクトリの下にあります。ステップ2： edb.crt追加コピーを作成します。ステップ3：ファイルedb_root.crt Distinguished Encoding Rules（DER）形式を作成します。このファイルの生成されたDER形式はedb_root.crt.derです。ファイルのDER形式は、ステップ4で使用されるkeytoolプログラムに必要です。ステップ4： keytoolプログラムを使用して、 edb_root.crt.derを入力として使用して、キーストアファイル（ postgresql.keystore ）を作成します。このプロセスにより、Postgresデータベースサーバーの証明書がキーストアファイルに追加されます。注：デフォルトのディレクトリロケーション~/.postgresql/postgresql.keystoreにアクセスできるように、ファイル名postgresql.keystoreをお勧めします。これは、EDB * Plusを呼び出すユーザーアカウントのホームディレクトリの下にあります。また、ファイル名の接尾辞は.keystore代わりに.jksにできることに注意してください（したがって、ファイル名postgresql.jks ）。ただし、これらの例の残りの部分では、ファイル名postgresql.keystoreが使用されます。Windowsのみ：パスは%APPDATA%\.postgresql\postgresql.keystorekeytoolプログラムは、下にありますbinのJava Runtime Environmentのインストールのサブディレクトリ。新しいパスワードの入力を求められます。 PGSSLCERTPASS環境変数で指定する必要があるため、このパスワードを保存します。注：デフォルトのディレクトリロケーション~/.postgresql/postgresql.p12にアクセスできるように、ファイル名postgresql.p12をお勧めします。これは、EDB * Plusを呼び出すユーザーアカウントのホームディレクトリの下にあります。Windowsのみ：パスは%APPDATA%\.postgresql\postgresql.p12新しいパスワードの入力を求められます。 このパスワードは、PGSSLKEYPASS環境変数で指定する必要があるため、保存します。Windowsの場合のみ：ディレクトリは%APPDATA%\.postgresqlステップ7：デフォルトの場所~/.postgresqlが使用されない場合、ファイルpostgresql.keystoreへのフルパス（ファイル名を含む）がPGSSLCERT環境変数で設定され、フルパス（ファイル名を含む）がEDB * Plusを呼び出す前に、 postgresql.p12ファイルをPGSSLKEY環境変数で設定する必要があります。さらに、ステップ4で生成されたファイルの名前が postgresql.keystoreまたはpostgresql.jks ない場合は、 PGSSLCERT環境変数を使用してファイル名とその場所を指定します。同様に、ステップ5で生成されたファイルの名前がpostgresql.p12でない場合は、 PGSSLKEY環境変数を使用してファイル名とその場所を指定します。
2.4 コマンドの要約2.4.1 承諾ACCEPTコマンドは、ユーザーのキーボード入力のためのプロンプトを待つを表示します。ユーザーが入力した値は、指定された変数に配置されます。ACC [EPT] variable2.4.2 追加APPENDは、指定されたテキストをSQLバッファー内の現在の行の末尾に追加する行エディターコマンドです。A [PPEND] text次の例では 、 APPENDコマンドを使用して、 SELECTコマンドがSQLバッファーに組み込まれています 。 SQLバッファ内の1つのスペースでdeptとWHEREを分離するために、 APPENDコマンドとWHERE句の間に2つのスペースが配置されることに注意してください。2.4.3 CHANGECHANGEは、 SQLバッファーの現在の行で検索と置換を実行する行エディターコマンドです。2.4.4 クリアCLEARコマンドは、SQLバッファの内容を削除して設定されたすべての列定義削除COLUMNコマンドを、または画面をクリアします。2.4.5 カラムCOLUMNコマンドは、出力フォーマットを制御します。 COLUMNコマンドを使用して設定されたフォーマット属性は、現在のセッションの間のみ有効です。COLUMNコマンドが後続のオプションなしで指定されている場合、セッションで有効な現在の列のフォーマットオプションが表示されます。場合 COLUMNコマンドは、列名が続き、その後、列名は、次のいずれかが続くことがあります。
{CONTINUE [COMMIT|ROLLBACK|NONE]
|EXIT [SUCCESS|FAILURE|WARNING| n | sub_variable ]
[COMMIT|ROLLBACK]}Advanced ServerがSQLコマンドまたはPL / SQLブロックの実行中にエラーを検出した場合、EDB * Plusは WHENEVER SQLERRORコマンドで指定されたアクションを実行します 。NONE句を含めて 、トランザクションをコミットまたはロールバックせずに続行するようにEDB * Plusに指示します。EXIT句を含めて 、指定されたアクションを実行し、エラーが発生した場合に終了するようにEDB * Plusに指示します。
目次