機械翻訳について

接続の管理

Data Studioからクラウド、カタログおよび共有に対して確立された接続がこのページにリストされています。

「接続」ページには、クラウド・ストレージ・リンク、データ・カタログ・リンク、共有プロバイダおよびエンティティ・カードのリストなどのエンティティの検索が含まれます。 検索するエンティティをフィールドに入力するか、リストからエンティティ・カードの1つをクリックします。 このページから、使用するクラウド・ストアを登録できます。 データ・カタログを登録し、共有プロバイダにサブスクライブすることもできます。

図connections.pngの説明

「接続」ページは、次の項目で構成されています:

1. エンティティ・セレクタ: ドロップダウン・リストを使用して、接続の作成元となるエンティティを選択できます。 クラウド・ストレージ・リンク、データ・カタログ・リンク、共有プロバイダまたはすべてから選択できます。
2. 「検索」フィールド: フィールド内のエンティティを名前で検索します。 検索機能では大/小文字が区別されず、一致するエントリがすべて取得され、ワイルドカード文字を使用する必要はありません。
3. 「作成」ドロップダウン: 「作成」ドロップダウンで使用可能なオプションは、次のとおりです:

   • 新規クラウド・ストアの場所: クラウド・ストアからデータをロードする前に、使用するクラウド・ストアへの接続を確立する必要があります。 「クラウド・ストアの場所」フィールドからクラウド・ストアの場所を選択できます。 クラウド・ストレージ・リンクは、クラウド・ストア内のバケットへの接続です。 既存のクラウド・ストレージ・リンクを表示したり、新しいクラウド・ストレージ・リンクを追加できます。 クラウド・ストアの場所を追加するには、「資格証明の作成」を参照してください。
   • 共有プロバイダへのサブスクライブ: JSONプロファイル・ファイルをアップロードし、共有プロバイダの説明を作成します。サブスクライブするには、共有プロバイダから受け取ったアップロード済JSONプロファイルに含まれる情報を使用する必要があります。 データ共有ツールの共有消費機能から、JSONプロファイルをアップロードし、サブスクライブ・ウィザードに従います。 詳細は、「バージョン管理された共有の消費」を参照してください。
   • データ・カタログの登録: データ・カタログ内のデータ・アセットとしてデータ・ソースを登録することで、接続を作成できます。 データ・カタログを表示、削除および名前変更できます。 データ・カタログの登録を参照してください。

4. ツールバーは次のボタンで構成されます:

   • ソート基準

     ソート値を選択するには、「ソート基準」ボタンをクリックしてオプションのリストを開きます。 次に、1つ以上のソート値の横にある「昇順」または「降順」アイコンをクリックします。 たとえば、「エンティティ名」の横にある「昇順」アイコンを選択し、「エンティティ・タイプ」の横にある「降順」アイコンを選択すると、エンティティは、エンティティ名でアルファベット順にソートされ、次にエンティティ・タイプでアルファベットの逆順にソートされます。

     リストの選択をクリアするには、リストで「リセット」をクリックします。

   • ページ・サイズ

     デフォルトでは、最大25個のエンティティがページに表示されます。 さらにエンティティをページに表示する場合は、このリストから数値を選択します。

   • 「前」および「次」

     検索結果が複数のページに表示される場合は、これらのボタンをクリックしてページ間を移動します。

   • リフレッシュ

     現在の検索フィールドに基づいて、ページに表示されたデータ・ロード・ジョブをリフレッシュする場合にクリックします。

5. 選択したソート値は、ツールバーの下の「ソート基準」ラベルの横に示されます。 ソート値を削除するには、その「X」アイコンをクリックします。

6. 表示領域: 「作成」ドロップダウン・フィールドの下の領域には、検索によって返されたエンティティ・カートが表示されます。

エンティティ詳細の表示

• 既存のエンティティの詳細を表示するには、「アクション」をクリックします。

• 共有プロバイダについては、「共有プロバイダ・エンティティ詳細の表示」を参照してください。

• クラウド・ストレージ・リンクの場合、「アクション」をクリックして次の操作を実行します:
  • 「詳細の表示」を選択して、表の詳細を表示します。
  • 「オブジェクト」を選択して、選択したストレージ・リンクで使用可能なオブジェクトを表示します。 ナビゲータ・ペインでファイルをクリックすると、表示領域に表示されます。
  • 「リンク表」を選択すると、データ・ロード・ツールの「データのリンク」ページが開き、「クラウドの場所URL」フィールドで選択したクラウド・ストレージ・リンクが表示されます。 クラウド・ストレージに存在するデータをAutonomous Databaseにリンクできます。 クラウド・ストレージ内のオブジェクトへのリンクを参照してください。
  • 「表のロード」を選択すると、データ・ロード・ツールの「データのロード」ページが開き、「クラウドの場所URL」フィールドで選択したクラウド・ストレージ・リンクが表示されます。 クラウド・ストレージに存在するデータをAutonomous Databaseにロードできます。 クラウド・ストレージからのデータのロードを参照してください。
  • 「ライブ表フィードの作成」を選択すると、ライブ表フィードの作成ウィザードが開き、「クラウドの場所URL」フィールドでクラウド・ストレージ・リンクが選択されます。 詳細は、「データのフィード」を参照してください。
  • 「編集」を選択して、クラウド・ストレージの場所の詳細を更新します。 クラウド・ストレージの場所の作成の詳細は、「資格証明の作成」を参照してください。
  • 「名前の変更」を選択して、クラウド・ストアの場所の名前を別の名前に変更します。
  • 「削除」を選択して、クラウド・ストアの場所を削除します。

• データ・カタログの登録
  データ・カタログの登録で使用するデータ・カタログを登録できます。
• 資格証明の作成
  資格証明を作成する手順は、クラウド・ストレージ・プロバイダによって異なります。 次のいずれかの方法で提供されるクラウド・ストア内にソース・ファイルがある場合は、そのプロバイダの例を参照してください。
• Oracle Cloud Infrastructureネイティブ資格証明の作成
  Data StudioからOracle Cloud Infrastructure (OCI) Object Storageサービスへのクラウド・ストレージ接続を確立するには、OCI認証の詳細を使用してクラウド・ストレージのロケーションを構成する必要があります。 DBMS_CLOUDパッケージのCREATE_CREDENTIALプロシージャを使用して、Oracle Cloud Infrastructure (OCI)ネイティブ資格証明を作成できます。
• Amazon Web Services (AWS)資格証明の作成
  AWS Glue Catalogにアクセスするには、資格証明の作成ウィザードで作成できるAWS資格証明が必要です。 このウィザードは、クラウド・サービス資格証明をAutonomous Databaseに格納します。
• DBMS_CLOUDを使用したリソース・プリンシパルの管理
  Oracle Cloud Infrastructure (OCI)リソース・プリンシパルを使用すると、OCI内で実行されているアプリケーションおよびサービスは、従来のデータベース資格証明(ユーザー名およびパスワードなど)を必要とせずにAutonomous Databaseにアクセスできます。

資格証明の作成

資格証明を作成する手順は、クラウド・ストレージ・プロバイダによって異なります。 次のいずれかによって提供されるクラウド・ストアにソース・ファイルが存在する場合は、そのプロバイダの例を参照してください。

• Oracle Cloud Infrastructure (OCI)の場合は、「OCIクラウド・ストアの場所の作成」を参照してください。
• Amazon S3、またはAWS APIをコールしている場合は、「Amazon S3クラウド・ストアの場所の作成」を参照してください。
• Microsoft Azure Blob Storage、またはAzure APIをコールしている場合は、「Microsoft Azureクラウド・ストアの場所の作成」を参照してください。
• Google Cloud Storageの場合は、Google Cloud Storageの場所の作成を参照してください。
• 「その他(Swift互換)」のクラウド・ストレージの場合は、「その他(Swift互換)のクラウド・ストアの場所の作成」を参照してください。
• ネイティブOCI資格証明を使用したOCIクラウド・ストレージの場合は、後続の項を参照してください。

  ノート:

  この方法は、OCI REST APIを使用する必要がある場合に推奨されます。 OCI REST APIを使用する場合は、ネイティブOCI資格証明を使用する必要があります。 Oracle Cloud Infrastructure署名キーを使用してOCIクラウド・ストレージの場所を作成するには、まずOracle Cloud Infrastructureネイティブ資格証明を作成する必要があります。

• OCI Cloud Shell。「OCI Cloud Shellを使用した資格証明の作成」を参照してください。

OCIクラウド・ストアの場所の作成

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。

   「資格証明」セクションで、「クラウドのユーザー名とパスワード」を選択します。

5. 「クラウド・ストア」ドロップダウン・リストから「Oracle」を選択します。
6. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

7. OCIクラウド・ストアの場合は、「Oracle Cloud Infrastructureユーザー名」フィールドにOCIユーザー名を入力します。 OCIコンソールのプロファイルからOracle Cloud Infrastructureユーザー名を使用する必要があります。 たとえば:

   oracleidentitycloudservice/[e-mail]

   または

   default/[e-mail]

8. OCIクラウド・ストアの場合は、「認証トークン」フィールドに認証トークンを入力します。 たとえば:

   LPB>Ktk(1M1SD+a]+r

9. 「バケットURI」フィールドに、OCIインスタンス・バケットのURIおよびバケットを入力します。
   1. URIおよびバケットを取得するには、Oracle Cloudインスタンスのオブジェクト・ストレージ・コンパートメントのバケットに移動します。
   2. 「オブジェクト」グループで、バケット内のファイルの「アクション」(縦に並んだ3つのドット)アイコンをクリックし、「オブジェクト詳細の表示」をクリックします。
   3. ファイル名を除くすべてのURLパス(URI)をコピーします。 必ず末尾のスラッシュを含めてください。 たとえば、ファイルhttps://objectstorage.us-phoenix-1.oraclecloud.com/n/myoci/b/my_bucket/o/MyFile.csvの場合、次を選択します:

       https://objectstorage.us-phoenix-1.oraclecloud.com/n/myoci/b/my_bucket/o/

   4. 文字列を「URI + バケット」フィールドに貼り付けます。
10. 「次」をクリックします。

    ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。

    ノート:

    新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
11. 「作成」をクリックして、クラウド・ストレージの場所を作成します。

Amazon S3クラウド・ストアの場所の作成

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。

   「資格証明」セクションで、「クラウドのユーザー名とパスワード」を選択します。

5. 「クラウド・ストア」ドロップダウン・リストから「Oracle」を選択します。
6. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

7. 「クラウド・ストア」ドロップダウン・リストから、「Amazon S3」を選択します。
8. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

9. 「AWSアクセス・キーID」フィールドに、AWSアクセス・キーIDを入力します。 例: myAccessKeyID
10. 「AWSシークレット・アクセス・キー」フィールドに、AWSシークレット・アクセス・キーを入力します。 AWSアクセス・キーの詳細は、「Managing access keys for IAM users」を参照してください。
11. 「バケットURI」フィールドに、Amazon S3バケットのURIおよびバケットを入力します。 たとえば:

    https://s3.us-west-2.amazonaws.com/my_bucket

12. 「次」をクリックします。

    ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。

    ノート:

    新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
13. 「作成」をクリックして、クラウド・ストレージの場所を作成します。

Microsoft Azureクラウド・ストアの場所の作成

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。

   「資格証明」セクションで、「クラウドのユーザー名とパスワード」を選択します。

5. 「クラウド・ストア」ドロップダウン・リストから「Microsoft Azure」を選択します。
6. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

7. 「Azureストレージ・アカウント名」フィールドに、Azureストレージ・アカウントの名前を入力します。 たとえば:

   myaccount

8. 「Azureストレージ・アカウント・アクセス・キー」フィールドに、Azureアクセス・キーを入力します。

   Azureストレージ・アカウントの詳細は、「Create a storage account」を参照してください。

9. 「バケットURI」フィールドに、Microsoft AzureバケットのURIおよびバケットを入力します。 たとえば:

   https://myaccount.blob.core.windows.net/mycontainer

10. 「次」をクリックします。

    ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。

    ノート:

    新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
11. 「作成」をクリックして、クラウド・ストレージの場所を作成します。

Microsoft Azureクラウド・ストアの場所の作成

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。

   「資格証明」セクションで、「クラウドのユーザー名とパスワード」を選択します。

5. 「クラウド・ストア」ドロップダウン・リストから「Microsoft Azure」を選択します。
6. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

7. 「Azureストレージ・アカウント名」フィールドに、Azureストレージ・アカウントの名前を入力します。 たとえば:

   myaccount

8. 「Azureストレージ・アカウント・アクセス・キー」フィールドに、Azureアクセス・キーを入力します。

   Azureストレージ・アカウントの詳細は、「Create a storage account」を参照してください。

9. 「バケットURI」フィールドに、Microsoft AzureバケットのURIおよびバケットを入力します。 たとえば:

   https://myaccount.blob.core.windows.net/mycontainer

10. 「次」をクリックします。

    ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。

    ノート:

    新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
11. 「作成」をクリックして、クラウド・ストレージの場所を作成します。

Google Cloud Storeの場所の作成

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。

   「資格証明」セクションで、「クラウドのユーザー名とパスワード」を選択します。

5. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

6. 「クラウド・ストア」ドロップダウン・リストから「Google」を選択します。
7. 「HMACアクセス・キー」フィールドに、HMACアクセスIDを入力します。 たとえば:

   GOOGTS1C3LPB3KTKSDMB2BFD

8. 「HMACアクセス・シークレット」フィールドに、HMACシークレットを入力します。 HMACキーの詳細は、「HMACキー」を参照してください。
9. クラウド・ストアの追加ダイアログ・ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

10. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

    My cloud storage link.

11. 「バケットURI」フィールドに、GoogleバケットのバケットおよびURIを入力します。 たとえば:

    https://my_bucket.storage.googleapis.com

12. 「次」をクリックします。

    ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。

    ノート:

    新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
13. 「作成」をクリックして、クラウド・ストレージの場所を作成します。

その他(Swift互換)のクラウド・ストアの場所の作成

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。

   「資格証明」セクションで、「クラウドのユーザー名とパスワード」を選択します。

   ノート:

   ユーザーOCID、テナンシOCID、秘密キーおよびフィンガープリントがある場合は、「Oracle Cloud Infrastructure署名キー」を選択し、このトピックの「Oracle Cloud Infrastructure署名キーを使用したOCIクラウド・ストレージの場所の作成」を参照してください。
5. 「クラウド・ストア」ドロップダウン・リストから、「その他(Swift互換)」を選択します。
6. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば:

   my_credential

7. 「アクセス・ユーザー名」フィールドに、アクセス・ユーザー名を入力します。 たとえば:

   OTHER_KEY123...

8. 「アクセス・キー」フィールドに、アクセス・キーを入力します。
9. 「バケットURI」フィールドに、クラウド・ストア・バケットのURIおよびバケットを入力します。 たとえば:

   https://someswiftcompatibleprovider.com/my_bucket

10. 「次」をクリックします。ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。 新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
11. 「作成」をクリックして、クラウド・ストレージの場所を作成します。

Oracle Cloud Infrastructure署名キーを使用したOCIクラウド・ストレージの場所の作成

Oracle Cloud Infrastructure署名キーを使用してOCIクラウド・ストレージの場所を作成するには:

1. 「接続」ページで、「作成」をクリックし、新規クラウド・ストアの場所の作成を選択します。 これにより、「クラウド・ストアの場所の追加」ウィザードが開きます。
2. 「クラウド・ストアの場所の追加」ボックスの「記憶域設定」タブで、クラウド・ストレージ・リンクの名前を入力します。 たとえば:

   My_Cloud_Store

3. (オプション)「説明」フィールドに、リンクの説明を入力します。 たとえば:

   My cloud storage link.

4. 「資格証明の選択」および「資格証明の作成」をクリックして、資格証明を作成します。 これにより、「資格証明の作成」ウィザードが開きます。
   ユーザーOCID、テナンシOCID、秘密キーおよびフィンガープリントがある場合は、「Oracle Cloud Infrastructure署名キー」を選択します。

   ノート:

   ユーザー名とパスワードのみの場合は、このステップで「クラウドのユーザー名とパスワード」を選択し、このトピックの「その他(Swift互換)のクラウド・ストアの場所の作成」を参照してください。

5. OCIアカウントに関する次の情報を指定します:

   資格証明名: 資格証明を識別する名前を指定します。 資格証明名を入力して資格証明名を指定するには、OCI資格証明オブジェクトの作成を参照してください。

6. フィンガープリント: RSAキー・ペアのフィンガープリント。 資格証明名を入力してフィンガープリントを入力するには、OCI資格証明オブジェクトの作成を参照してください。

7. 秘密キー: RSAキー・ペアの暗号化されていない秘密キー。 これは、パスフレーズを使用して暗号化しないでください。 資格証明名を入力して秘密キーを入力するには、OCI資格証明オブジェクトの作成を参照してください。

8. Oracle Cloud Infrastructureテナンシ: テナントのOCID。 テナンシのOCIDを取得する方法の詳細は、テナンシのOCIDとユーザーのOCIDの取得場所に関する項を参照してください。

9. Oracle Cloud Infrastructureユーザー名: ユーザーのOCID。 ユーザーのOCIDを取得する方法の詳細は、テナンシのOCIDとユーザーのOCIDの取得場所に関する項を参照してください。

10. 「資格証明の作成」を選択します。
11. 「バケットURI」フィールドに、クラウド・ストア・バケットのURIおよびバケットを入力します。 たとえば:

    https://objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<bucket>/

12. 「次」をクリックします。

13. ダイアログ・ボックスが「クラウド・データ」タブに進みます。 このタブでは、このクラウド・ストレージの場所で使用可能なオブジェクトが表示領域にリストされます。

    ノート:

    新しいクラウド・ストレージの場所を作成する際、表示領域は空白です。
14. 「作成」をクリックします。

クラウド・ストレージの場所が正常に作成されたという通知を受け取ります。

OCI Cloud Shellを使用した資格証明の作成

クラウド・シェル・スクリプトを使用してOCIのネイティブ資格証明を作成できます。

OCI Cloud Shellを使用して資格証明を作成するには、adb-create-cred.shを実行して資格証明スクリプトを生成する必要があります。 adb-create-cred.shスクリプトは既存の資格証明を検索し、見つかった場合、ユーザーはそれらを再利用するか、新しい資格証明を作成するかを尋ねられます。 生成された資格証明スクリプトには、決定に応じて新しい資格証明または既存の資格証明が含められます。 OCIネイティブ資格証明スクリプトをダウンロードするか、それをコピーして、任意のSQL、JSONツールまたはユーティリティを使用してデータベース内で直接実行します。

ノート:

資格証明作成スクリプトでサポートされている引数のリストについては、adb-create-cred.sh --helpと入力します。

この例では、OCIネイティブ資格証明スクリプトはテナンシのスクリプト領域に生成され、データベースでは実行されません。

1. 「接続」ページで、「作成」をクリックし、「新規クラウド・ストアの場所」を選択します。 新しい資格証明を作成するには、資格証明の名前とクラウド・ストアの場所を知っている必要があります。
2. 「資格証明の作成」を選択します。
3. 資格証明の作成ウィザードで、「OCIクラウド・シェルを使用して作成」を選択します。 スクリプト・エディタ・フィールドにスクリプトが表示されます。

   ノート:

   • ホーム・リージョンで操作していて、Autonomous Databaseがホーム・リージョンにある場合は、region引数を指定せずにスクリプトを実行します。 このスクリプトは、Autonomous Databaseがホーム・リージョンに存在し、代替リージョンの入力を求めないことを前提としています。
   • ホーム・リージョンで操作していて、Autonomous Databaseが代替リージョンにある場合は、スクリプトの実行時に--region引数を渡す必要があります。
4. スクリプトのコピーをクリックします。
5. OCIテナンシにサインインし、開発者ツール・アイコンを選択して、ドロップダウン・リストからクラウド・シェルをクリックします。
   
   
   
   図cloud_shell1.pngの説明
   
   
6. 前のステップでコピーしたadb-create-cred.shスクリプトを貼り付けます。これには、ツールがデータベースを検索してデータベースに接続するために使用する引数、および「資格証明名」フィールドに指定した資格証明名が含まれます。
   
   
   
   図cloud_shell2.pngの説明
   
   
7. クラウド・シェル・スクリプトによって、既存のOCI APIキーおよびフィンガープリントが通知され、再利用するかどうかを尋ねられます。 既存のキーおよびフィンガープリントを再利用するには、y と入力します。
   
   
   
   図cloud_shell3.pngの説明
   
   

   新しい資格証明を作成して資格証明を上書きした後に、上書きされた資格証明を使用することを決定した場合は、バックアップがあるディレクトリに戻って再利用できます。 バックアップ・ファイル名またはフォルダには、_bkp_YYYYMMDD_abcという構文の接尾辞が付きます。 たとえば、次のバックアップ・ファイルは2024年6月6日に作成されました: _bkp_20240603_woT。

8. Autonomous Databaseで資格証明スクリプトを実行する場合、クラウド・シェル・スクリプト・ウィンドウが表示されます。 yと入力して、リージョン、コンパートメントおよびデータベース引数を使用してデータベースで資格証明スクリプトを実行します。
   
   
   
   図cloud_shell4.pngの説明
   
   
9. ウォレット・ファイルがないことを示す通知が表示されることがあります。 このスクリプトにより、ウォレット・ファイルが作成されます。 データベースへの接続に使用するADMINパスワードを指定する必要があります。 スクリプトによってウォレット・ファイルが検出された場合、ウォレット・ファイルを再利用するか、新しいウォレット・ファイルを設定するかを尋ねるプロンプトがスクリプトによって表示されます。
   
   
   
   図cloud_shell5.pngの説明
   
   

   ノート:

   仮想クラウド・ネットワークにAutonomous Databaseのプライベート・エンドポイントがある場合、adb-create-cred.shスクリプトによってSQLおよびJSONスクリプトが生成されます。 ただし、Autonomous Databaseプライベート・エンドポイントへのアクセスに必要なステップは実行されません。 かわりに、cat ~/oci_native_credential.sqlを実行して、Bastionまたはジャンプ・ホストを介してアクセス可能なSQLツールにSQLをコピーするように求められます。

10. クラウド・シェル・スクリプトによって、ログインの成功と特定のデータベースでの資格証明の作成の通知が表示されます。

    このスクリプトによって、別のデータベースでこれを実行するかどうかを確認するプロンプトが表示されます。 別のデータベースで資格証明を実行しない場合は、nと入力します。

    スクリプトが終了し、資格証明を作成するoci_native_credential.sqlスクリプトを実行するためのパスが表示されます。

    
    
    
    図cloud_shell6.pngの説明
    
    

    ノート:

    Autonomous Databaseへの接続が失敗した場合は、cat ~/oci_native_credential.sqlを実行し、SQLをコピーして、任意のSQLツールを使用してSQLを直接データベースで実行できます。

Oracle Cloud Infrastructureネイティブ資格証明の作成

Data StudioからOracle Cloud Infrastructure (OCI) Object Storageサービスへのクラウド・ストレージ接続を確立するには、OCI認証の詳細を使用してクラウド・ストレージの場所を構成する必要があります。 DBMS_CLOUDパッケージのCREATE_CREDENTIALプロシージャを使用して、Oracle Cloud Infrastructure (OCI)ネイティブ資格証明を作成できます。

Oracle Cloud Infrastructure (OCI)資格証明オブジェクトの作成

オブジェクト・ストレージにアクセスするには、DBMS_CLOUDパッケージのCREATE_CREDENTIALプロシージャを使用して作成できる資格証明が必要です。 DBMS_CLOUDでは、OCIネイティブ認証が含まれる資格証明オブジェクトの作成がサポートされています。 DBMS_CLOUDプロシージャは、クラウド・サービス資格証明をAutonomous Databaseに格納します。

DBMS_CLOUD.CREATE_CREDENTIALプロシージャは、Oracle Cloud Infrastructure関連のパラメータ(user_ocid、tenancy_ocid、private_key、fingerprintなど)でオーバーロードされます。 これは、Oracle Cloud Infrastructure署名キー認証を使用するためのものです。

オブジェクト・ストア資格証明オブジェクトの作成時に、OCIネイティブ認証資格証明を作成します。 OCIネイティブ認証では、DBMS_CLOUD.CREATE_CREDENTIALプロシージャに次のパラメータが含まれます:

表3-2 DBMS_CLOUD.CREATE_CREDENTIALパラメータの説明

パラメータ	説明
credential_name	credential_nameパラメータは、Oracleオブジェクトのネーミング規則に準拠している必要があります。
user_ocid	ユーザーのOCIDを指定します。 ユーザーのOCIDを取得する方法の詳細は、テナンシのOCIDとユーザーのOCIDの取得場所に関する項を参照してください。
tenancy_ocid	テナンシのOCIDを指定します。 テナンシのOCIDを取得する方法の詳細は、テナンシのOCIDとユーザーのOCIDの取得場所に関する項を参照してください。
private_key	生成した秘密キーを指定します。 パスフレーズ付きで生成したプライベート・キーはサポートされていません。 この秘密キーは、パスフレーズなしで生成する必要があります。 PEM形式でキー・ペアを生成する方法の詳細は、API署名キーの生成方法に関する項を参照してください。
fingerprint	フィンガープリントを指定します。 ユーザーのアカウントに生成した公開キーをアップロードすると、コンソールにフィンガープリントが表示されます。 この引数には表示されたフィンガープリントを使用します。 詳細は、キーのフィンガープリントの取得方法に関する項およびAPI署名キーの生成方法に関する項を参照してください。

DBMS_CLOUD.CREATE_CREDENTIALプロシージャの構文は次のとおりです:

DBMS_CLOUD.CREATE_CREDENTIAL (
	credential_name IN VARCHAR2,
	user_ocid       IN VARCHAR2,
	tenancy_ocid    IN VARCHAR2,
	private_key     IN VARCHAR2,
	fingerprint     IN VARCHAR2);

必要なすべての入力を取得し、秘密キーを生成したら、CREATE_CREDENTIALプロシージャのサンプルを次に示します:

BEGIN  DBMS_CLOUD.CREATE_CREDENTIAL (    credential_name =>
      'OCI_NATIVE_CRED',    user_ocid              =>
      'ocid1.user.oc1..aaaaaaaatfn77fe3fxux3o5lego7glqjejrzjsqsrs64f4jsjrhbsk5qzndq',    tenancy_ocid           =>
      'ocid1.tenancy.oc1..aaaaaaaapwkfqz3upqklvmelbm3j77nn3y7uqmlsod75rea5zmtmbl574ve6a',    private_key            =>
      'MIIEogIBAAKCAQEAsbNPOYEkxM5h0DF+qXmie6ddo95BhlSMSIxRRSO1JEMPeSta0C7WEg7g8SOSzhIroCkgOqDzkcyXnk4BlOdn5Wm/BYpdAtTXk0sln2DH/GCH7l9P8xC9cvFtacXkQPMAXIBDv/zwG1kZQ7Hvl7Vet2UwwuhCsesFgZZrAHkv4cqqE3uF5p/qHfzZHoevdq4EAV6dZK4Iv9upACgQH5zf9IvGt2PgQnuEFrOm0ctzW0v9JVRjKnaAYgAbqa23j8tKapgPuREkfSZv2UMgF7Z7ojYMJEuzGseNULsXn6N8qcvr4fhuKtOD4t6vbIonMPIm7Z/a6tPaISUFv5ASYzYEUwIDAQABAoIBACaHnIv5ZoGNxkOgF7ijeQmatoELdeWse2ZXll+JaINeTwKU1fIB1cTAmSFv9yrbYb4ubKCJuYZJeC6I92rT6gEiNpr670Pn5n43cwblszcTryWOYQVxAcLkejbPA7jZd6CW5xm/vEgRv5qgADVCzDCzrij0t1Fghicc+EJ4BFvOetnzEuSidnFoO7K3tHGbPgA+DPN5qrO/8NmrBebqezGkOuOVkOA64mp467DQUhpAvsy23RjBQ9iTuRktDB4g9cOdOVFouTZTnevN6JmDxufu9Lov2yvVMkUC2YKd+RrTAE8cvRrn1A7XKkH+323hNC59726jT57JvZ+ricRixSECgYEA508e/alxHUIAU9J/uq98nJY/6+GpI9OCZDkEdBexNpKeDq2dfAo9pEjFKYjH8ERj9quA7vhHEwFL33wk2D24XdZl6vq0tZADNSzOtTrtSqHykvzcnc7nXv2fBWAPIN59s9/oEKIOdkMis9fps1mFPFiN8ro4ydUWuR7B2nM2FWkCgYEAxKs/zOIbrzVLhEVgSH2NJVjQs24S8W+99uLQK2Y06R59L0Sa90QHNCDjB1MaKLanAahP30l0am0SB450kEiUD6BtuNHH8EIxGL4vX/SYeE/AF6tw3DqcOYbLPpN4CxIITF0PLCRoHKxARMZLCJBTMGpxdmTNGyQAPWXNSrYEKFsCgYBp0sHr7TxJ1WtO7gvvvd91yCugYBJAyMBr18YY0soJnJRhRL67A/hlk8FYGjLW0oMlVBtduQrTQBGVQjedEsepbrAcC+zm7+b3yfMb6MStE2BmLPdF32XtCH1bOTJSqFe8FmEWUv3ozxguTUam/fq9vAndFaNre2i08sRfi7wfmQKBgBrzcNHN5odTIV8l9rTYZ8BHdIoyOmxVqM2tdWONJREROYyBtU7PRsFxBEubqskLhsVmYFO0CD0RZ1gbwIOJPqkJjh+2t9SH7Zx7a5iV7QZJS5WeFLMUEv+YbYAjnXK+dOnPQtkhOblQwCEY3Hsblj7Xz7o=',    fingerprint            =>
      '4f:0c:d6:b7:f2:43:3c:08:df:62:e3:b2:27:2e:3c:7a');END;/ 
    PL/SQL procedure successfully completed.

次の問合せで新しい資格証明を取得できるようになりました。

SELECT owner, credential_name FROM dba_credentials WHERE credential_name LIKE '%NATIVE%';  OWNER CREDENTIAL_NAME----- ---------------
    ADMIN OCI_NATIVE_CRED

Amazon Web Services (AWS)資格証明の作成

AWS Glue Catalogにアクセスするには、資格証明の作成ウィザードで作成できるAWS資格証明が必要です。 このウィザードでは、クラウド・サービスの資格証明をAutonomous Databaseに格納します。

ソース・ファイルが存在する場所に応じて、CREATE CREDENTIALウィザードを使用します。 AWS資格証明を作成するには:

1. 「接続」ページで、「作成」をクリックし、「新規クラウド・ストアの場所」を選択します。

   
   
   
   図connections1.pngの説明
   
   
2. 「クラウド・ストアの場所の追加」ウィザードから「資格証明の作成」を選択します。
   
   
   
   図aws-credential.pngの説明
   
   
3. 「クラウドのユーザー名とパスワード」を選択します。
4. 「クラウド・ストア」ドロップダウンから、「Amazon S3」を選択します。
5. 「資格証明名」フィールドに名前を入力します。 名前は、Oracleオブジェクトのネーミング規則に準拠している必要があります。 たとえば、MY_AWS_CREDです。
6. 「AWSアクセス・キーID」 フィールドに、AWSアクセス・キーIDを入力します。 たとえば、myAccessKeyIDです。「IAMユーザーのアクセス・キーの管理」を参照してください。
7. 「AWSシークレット・アクセス・キー」フィールドに、AWSシークレット・アクセス・キーを入力します。 AWSアクセス・キーの詳細は、「Managing access keys for IAM users」を参照してください。
8. 「資格証明の作成」をクリックして、AWS資格証明を作成します。

DBMS_CLOUDを使用したリソース・プリンシパルの管理

Oracle Cloud Infrastructure (OCI)リソース・プリンシパルを使用すると、OCI内で実行されているアプリケーションとサービスは、従来のデータベース資格証明(ユーザー名とパスワードなど)を必要とせずにAutonomous Databaseにアクセスできます。

リソース・プリンシパルを使用する場合、資格証明オブジェクトを作成する必要はありません。 Autonomous Databaseは、指定したOracle Cloud Infrastructureリソースへのアクセスに使用するリソース・プリンシパル資格証明を作成および保護します。 リソース・プリンシパルは、データベースが他のOracle Cloud Infrastructureサービスに対して自身を認証できるようにする一時セッション・トークンおよびセキュアな資格証明で構成されます。

Autonomous Databaseでリソース・プリンシパルを使用するための前提条件:

• Autonomous Databaseでリソース・プリンシパルを設定するには、いくつかのステップが必要です。Oracle Cloud Infrastructure Identity and Access Management (IAM)ポリシーを作成して定義する必要があります。 詳細は、Autonomous Databaseでリソース・プリンシパルを使用するための前提条件の実行を参照してください。
• ADMINユーザーのリソース・プリンシパルを有効にし、オプションでデータベース・ユーザーのリソース・プリンシパルを有効にします。 OCIリソースにアクセスするには、リソース・プリンシパルの有効化を参照してください。

リソース・プリンシパルを使用して認証する場合、OCIリソースにアクセスするための資格証明を作成および管理する必要はありません。 Autonomous Databaseにより、リソース・プリンシパルが使用可能になり、リソース・プリンシパルが保護されます。

Data Studioを使用したリソース・プリンシパルの管理

Data Studioを使用してリソース・プリンシパルを有効にすることもできます。

1. データベース・アクションの起動パッドから、「データ・ロード」タイルを選択します。

2. 「接続」をクリックします。これにより、「接続」ページが開きます。

3. 「接続」ページで、「作成」をクリックし、「リソース・プリンシパルの管理」を選択します。
   
   
   図enable-resource.pngの説明
   
   

   「リソース・プリンシパルの管理」ダイアログが開きます。

   
   
   
   図manage-resource.pngの説明
   
   
4. 「使用可能なユーザー」リストから「選択したユーザー」リストに追加するユーザーを選択して、そのリソース・プリンシパルを有効にします。

   次のいずれかのオプションを選択します。

   • >: このオプションを使用すると、ユーザーを「選択したユーザー」に移動できます。

     <: 選択したユーザーを「選択したユーザー」から削除するには、このオプションを選択します。

     >>: このオプションを使用すると、すべての表を「選択したユーザー」リストに移動できます。

     <<: 選択したすべてのユーザーを「選択したユーザー」から削除するには、このオプションを選択します。

     
     
     
     図drag-user.pngの説明
     
     

   ノート:

   リソース・プリンシパル資格証明へのアクセス権をデータベース・ユーザーに付与できるのは、ADMINユーザーがリソース・プリンシパル資格証明を有効にした場合のみです。

5. 「コードの表示」オプションを選択して、「リソース・プリンシパルの管理」ダイアログ・ボックスと同等のPL/SQLコードを表示します。 「リソース・プリンシパルの管理」ダイアログ・ボックスで「リソース・プリンシパルの有効化」をクリックしたときと同じアクションを実行するために、ワークシートでこのPL/SQLコードをコピーして実行できます。
   
   
   図show-code-manage.pngの説明
   
   
6. 「実行」をクリックして、選択したユーザーのリソース・プリンシパルを有効にするプロセスを完了します。

   選択したユーザーのリソース・プリンシパルが有効になっていることを確認する確認通知が表示されます。

7. 選択したユーザーのリソース・プリンシパルを無効化するには、「選択したユーザー」から「使用可能なユーザー」にユーザーを選択します。 これは、資格証明OCI$RESOURCE_PRINCIPALを削除します。 このトピックの詳細は、Autonomous Databaseのリソース・プリンシパルの無効化を参照してください。