9.8 CONMGR

次のサブコマンドがあります:

9.8.1 接続のクローニング

既存の接続をクローニングします。デフォルトでは、元の接続とともに格納された資格証明が新しい接続に使用されます。ユーザー名を変更するには、-userオプションを使用できます。ユーザーが変更すると、-nopwdオプションを使用しないかぎり、パスワード・プロンプトが表示されます

構文

connmgr|cm clone {OPTIONS} {PARAMETERS}

オプション

オプション 説明 デフォルト
-original、-o クローニングされるソース接続の名前。 必須
-nopwd 格納されたパスワードなしで接続を作成するかどうか。 -
-user、-u 接続とともに格納するユーザー名です。ユーザー名を指定しない場合、認証構成に応じて、接続の使用時に指定を求めるプロンプトが表示されることがあります。 -

パラメータ

パラメータ 説明
<name> 接続の名前。接続名では大文字と小文字が区別されます。

例

既存の接続をクローニングするには:

SQL> CONNMGR CLONE -original original_name newname
SQL> CONNMGR CLONE -original original_name -user newuser newname

9.8.2 接続のインポート

共通の接続ストアに、1つ以上の接続をインポートします。

接続ファイルには、暗号化されたパスワードやその他の資格証明が含まれている可能性があります。

暗号化されたパスワードを使用して接続をインポートする場合、パスワードを復号化するために暗号化キーが必要です。暗号化キーは、最初にシークレットで保護することにより、importコマンドで指定できます。シークレットの使用方法の詳細は、SECRETコマンドを参照してください。importコマンドにキーが指定されていない場合は、キーをリクエストするためのプロンプトが表示されます。

パスワードは、-strip_passwordsオプションを指定することにより、インポートされた接続から削除できます。

構文

connmgr|cm import {OPTIONS} {PARAMETERS}

オプション

オプション 説明
-duplicates | d | dups

{ignore|rename|replace}

名前が既存の接続と一致するインポートされた接続の処理方法を示します。

  • IGNORE: 重複する接続をスキップします。
  • RENAME: 名前の最後に一意の番号を追加して、重複する接続の名前を変更します。
  • REPLACE: 既存の接続を新しい接続に置き換えます。
-key ファイル内のパスワードの暗号化に使用される暗号化キーを保護するシークレットのパブリック名。

ノート:

暗号化キーが無効な場合、接続は削除されたパスワードでインポートされます。
-strip_passwords | s | strip 暗号化されたパスワードがインポートされた接続から削除されることを示します。

パラメータ

パラメータ 説明
path インポートする1つ以上の接続を含む単一のファイルまたはディレクトリ。パスがアーカイブ・ファイルの場合、アーカイブで単一の接続定義がチェックされます。パスがJSONファイルの場合は、レガシー接続定義がチェックされます。パスがディレクトリの場合、接続定義を含むアーカイブがさらに存在するかどうかがチェックされます。

例

暗号化キーのシークレットを作成し、ファイルから接続をインポートするときにシークレット名を指定するには、次のようにします。

SQL> SECRET SET mySecret <encryption key>
  SQL> CONNMGR IMPORT -KEY mySecret myconns.json

9.8.2.1 SECRETコマンド

このコマンドは、シークレット値をメモリーに安全に格納するために使用されます。接続マネージャ(connmgr)コマンドを使用すると、秘密名を使用して、パスワードや暗号化キーなどのセキュアな値を識別できます。このようにシークレット名を使用すると、セキュアな値がコマンドラインに表示されず、コマンド履歴に保持されなくなります。セキュアな値はSECRETコマンドでは取得できません。

構文

secret {SUBCOMMAND}

サブコマンドは次のとおりです。

Set

シークレット値の名前を設定します。シークレット名は、セキュアな値をサポートするコマンドで使用できます。

構文

secret set {PARAMETERS}

パラメータ

パラメータ 説明
secret_name セキュアな値を表すために使用できるパブリック名。
secret_value シークレット名に関連付けられている保護されたシークレット値。

List

現在格納されているシークレット名をリストします。

構文

secret list

Unset

シークレット名のシークレット値を削除します。

構文

 secret unset <secret_name>

secret_nameは、シークレット値を表すために使用されるパブリック名です。

例

シークレット値の名前を設定し、それを使用して接続をインポートします。

SQL> secret set my_name myEncryptionKey
secret my_name stored
SQL> connmgr import -encryption_key my_name conns.json

9.8.3 接続のリスト

接続名をリストします。

構文

cnnmgr|cm list

例

接続の名前をリストするには、次のように入力します:

SQL> CONNMGR LIST

9.8.4 接続の表示

接続URLおよびユーザー名(格納されている場合)を含む接続の詳細を表示します。格納されている接続の説明に応じて、追加の詳細が表示されます。

構文

connmgr|cm show {PARAMETERS}

パラメータ

パラメータ 説明
<name> 接続の名前。接続名では大文字と小文字が区別されます。

例

MyConnectionの詳細を表示するには: 

SQL> CONNMGR SHOW MyConnection

9.8.5 接続のテスト

テスト接続を開き、閉じます。このテスト接続は、現在のSQLcl接続には影響しません。接続とともに格納された資格証明がテストに使用されます。パスワードが格納されていない場合は、パスワードの入力が求められます。-userオプションが使用されている場合、指定されたユーザーがかわりにテストされます。プロンプトが表示されたら、パスワードを指定する必要があります。

構文

connmgr|cm test {OPTIONS} {PARAMETERS}

オプション

オプション 説明
-user、-u 接続定義に格納されているユーザー名を使用するかわりに、ユーザー名を指定します。大/小文字を区別するユーザー名は、大/小文字を保持するために引用符で囲みます。

パラメータ

パラメータ 説明
<name> 接続の名前。接続名では大文字と小文字が区別されます。

例

ユーザー名SCOTTの接続MyConnectionをテストするには: 

SQL> CONNMGR TEST MyConnection
SQL> CONNMGR TEST -USER SCOTT MyConnection