カタログの管理

• Autonomous AI Databaseにオブジェクト・ストレージ資格証明を格納します
• データベース・リンクの作成または既存のデータベース・リンクの使用
• データベース・リンクをカタログとしてマウントします。

• データベース・リンク名
• データへのアクセスに必要なクラウド資格証明

1. Icebergエンドポイント: Iceberg REST APIを使用してPolarisまたはUnityカタログを設定します。これには、カタログ・タイプ、URIおよびレイクハウスの場所の指定が含まれます。外部IcebergカタログのRESTエンドポイントが必要です。これは、Icebergメタデータへのアクセスを提供するURLです。

   例: https://your-iceberg-catalog.com/api/v1/iceberg

2. トークン・エンドポイント: /v1/oauth/tokensエンドポイントは、ベアラー・トークンを発行するためにIceberg RESTカタログによって提供されます。
3. クライアントIDとクライアント・シークレット: これらは、アプリケーションを識別するためにOAuthサーバーによって提供される資格証明です(この場合、UnityとPolarisカタログの統合)。これらの資格証明を使用して、Bearerトークンを生成します。
4. ベアラー・トークン: Iceberg RESTエンドポイントへのリクエストを認証するには、OAuthをクライアント資格証明とともに使用します。カタログ・ツールは、トークン・エンドポイントをコールしてベアラー・トークンを受信します。
5. ネームスペース: ネームスペースは、データベース内のスキーマと同等です。この場所は、カタログ内のIceberg表のリポジトリとして機能します。Icebergカタログは、表をネームスペースにグループ化し、他のネームスペース内にネストできます。Iceberg仕様は、任意のレベルのネスティングをサポートします。

   たとえば、SALES表はSTORESネームスペース内で定義できます。このネームスペースはRETAILネームスペースで定義され、それ自体はCORPORATEネームスペース内で定義されます。このような表のIcebergの場所は、 CORPORATE.RETAIL.STORES.SALESです。

CREATE OR REPLACE CATALOG INTEGRATION tabular_catalog_int
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'default'
  REST_CONFIG = (
    CATALOG_URI = 'https://api.tabular.io/ws'
    CATALOG_NAME = '<tabular_lakehouse_name>'
  )
  REST_AUTHENTICATION = (
    TYPE = OAUTH
    OAUTH_TOKEN_URI = 'https://api.tabular.io/ws/v1/oauth/tokens'
    OAUTH_CLIENT_ID = '<oauth_client_id>'
    OAUTH_CLIENT_SECRET = '<oauth_secret>'
    OAUTH_ALLOWED_SCOPES = ('catalog')
  )
  ENABLED = TRUE;

1. 「カタログ」ページで、「カタログの管理」を選択します。+Addをクリックします。
2. 「カタログの追加」ダイアログで、「カタログ・ソース」タブから「アイスバーグ・カタログ」を選択します。
   
   
   
   図add-catalog-iceberg.pngの説明
   
   

   「次へ」をクリックします。

3. 「カタログの追加」ダイアログの「カタログ・ソース」タブで、次のフィールド値を指定します。

   • カタログ名: Icebergカタログをマウントするカタログの名前を入力します。

     たとえば、Polarisです。

   • Icebergカタログ・タイプ: ドロップダウン・フィールドから「Polaris」を選択します。

   • Icebergカタログ・エンドポイント: Polarisカタログ・アカウントURLを指定します。SnowflakeのPolarisカタログのエンドポイントは、通常、https://<account_locator>.snowflakecomputing.com/polaris/api/catalogの形式です。アカウント識別子の書式の詳細は、Snowflakeのドキュメントを参照してください。
   • アイスバーグ・カタログ資格証明: ドロップダウン・リストの使用可能な資格証明のリストから資格証明を選択します。資格証明がない場合、資格証明を作成できます。「資格証明の作成」を選択します。「資格証明の作成」ダイアログで、次のフィールド値を指定します。
     • 資格証明名: 資格証明の名前を入力します。たとえば、POLARIS_CREDです。
       「新しいBearerトークンの取得」で、

       • アクセス・トークン・エンド・ポイント: Iceberg REST仕様エンドポイントを入力します。これにより、/v1/oauth/tokensとして定義されたOAuth2を使用してアクセス・トークンが生成されます。

         このエンドポイントは、クライアント資格証明(クライアントIDおよびシークレット)をアクセス・トークンと交換することで認証を容易にするように設計されています。

         ノート
         
         /v1/oauth/tokensエンドポイントは、Icebergバージョン1.6.0では非推奨であり、バージョン2.0では削除されます。かわりに、外部のOAuth2プロバイダを使用することをお薦めします。詳細は、OAuth認証を参照してください。
       • 付与タイプ: 「クライアント資格証明」を選択します。
       • クライアントID: クライアントIDを指定します。
       • クライアント・シークレット: クライアント・シークレットを指定します。
       • スコープ: PRINCIPAL_ROLE:ALL。

         「トークンの取得」をクリックします。

         「ベアラー・トークン」フィールドに値が移入されます。

       「資格証明の作成」をクリックします。

       POLARIS_CREDは、Icebergカタログ資格証明として表示されます。

       
       
       
       図create-credential-polaris.pngの説明
       
       
       ノート
       
       

       資格証明は、バックエンドのプロシージャDBMS_CLOUD.CREATE_CREDENTIALを使用して格納されます。

       前述の例では、プロシージャは次のようになります。

       BEGIN
         dbms_cloud.create_credential( 
           credential_name  =>  'POLARIS_CRED',
           username         =>  'BEARER_TOKEN',
           password         =>  '<BEARER_TOKEN_VALUE This is generated using token endpoint, client id, client secret>'
         );
       END;

     
     
     
     図add-polaris-catalog-source.pngの説明
     
     

     この資格証明により、Oracle Autonomous AI DatabaseはIceberg表にアクセスできます。

   • バケット資格証明: この資格証明は、Iceberg表をParquet形式で格納するためのクラウド・ストレージ・ボリュームを格納します。Polarisカタログの場合、このフィールドは必須です。

     「次」をクリックして、「アイスバーグ・カタログ」タブに進みます。

4. 「アイスバーグ・カタログ」タブで、次のフィールド値を指定できます:

   • アイスバーグ・カタログ・ネームスペース: このフィールドには、表の階層組織が表示されます。Icebergカタログ・エンドポイントは、ルート・ネームスペースで構成されます。カタログをマウントするネームスペースを選択します。
   • ネームスペース・セパレータ・スタイル: 「Polarisスタイル」を選択します。これはデフォルト値です。カタログの構成方法に基づいて任意の値を選択します。
     ノート
     
     デフォルト値を保持することをお薦めします。
   • バケット・リージョン: バケット・リージョンを入力します。たとえば、us-west-2です。

     Icebergカタログ・エンドポイントは、S3などのクラウド・ストレージに格納されているIceberg表を管理するためのインタフェースとして機能します。バケット・リージョンは、S3バケットがホストされている地理的な場所を参照します。

     これはPolarisカタログの必須フィールドです。

     
     
     
     図namespace-polaris.pngの説明
     
     

   「追加」をクリックします。

   新しいカタログをIcebergカタログに正常にマウントした後、「カタログの管理」ページでPolarisカタログを表示できます。このページからカタログを無効にして削除できます。

   
   
   
   図manage-polaris-catalogs.pngの説明
   
   

1. 「カタログ」ツールで、「カタログの選択...」をクリックします。
2. 「カタログおよびスキーマ」ウィザードで「POLARIS _CATALOG」フィルタをクリックして、POLARIS_CATALOGカタログを表示します。
3. 「適用」をクリックして、カタログ・ページに結果を表示します。
   
   
   
   図catalogs-schemas-polaris-catalog.pngの説明
   
   

1. 「カタログ」ページで、「カタログの管理」を選択します。+Addをクリックします。
2. 「カタログの追加」ダイアログで、「アイスバーグ・カタログ」を選択します。
   
   
   
   図add-catalog-iceberg.pngの説明
   
   
3. 「次へ」をクリックします。
4. 「カタログの追加」ダイアログの「カタログ・ソース」タブで、次のフィールド値を指定します。
   • カタログ名: Icebergカタログをマウントするカタログの名前を入力します。

     たとえば、Unityです。

   • Icebergカタログ・タイプ: ドロップダウン・フィールドから「Unity」を選択します。
   • Icebergカタログ・エンドポイント:

     Unityカタログの場合、通常、Databricks REST APIを使用します。Unity Catalogを介してIceberg表にアクセスする際のエンドポイントは、通常、https://<databricks-instance-url>/api/2.1/unity-catalog/icebergの形式です。

     ノート
     
     詳細は、https://docs.databricks.com/aws/en/external-access/icebergを参照してください。
   • アイスバーグ・カタログ資格証明: ドロップダウン・リストの使用可能な資格証明のリストから資格証明を選択します。資格証明がない場合、資格証明を作成できます。「資格証明の作成」を選択します。
     「資格証明の作成」ダイアログで、次の値を指定します。

     • 資格証明の名前: 資格証明の名前を入力します。たとえば、UNITY_CREDです。
     • ベアラー・トークン: ベアラー・トークン値を貼り付けます。

       「資格証明の作成」を選択します。

       UNITY_CREDは、アイスバーグ・カタログ資格証明として表示されます。

     
     
     
     図add-unity-catalog.pngの説明
     
     

     「次へ」をクリックして、「アイスバーグ・カタログ」タブに進みます。

     「アイスバーグ・カタログ」タブで、次のフィールド値を指定できます:

   • アイスバーグ・カタログ・ネームスペース: アクセスが必要なスキーマのいずれかを選択します。
   • ネームスペース・セパレータ・スタイル: ネームスペース・セパレータ・スタイルは、通常、ネームスペースをカタログ内で構造化および分離する方法を指します。デフォルトでは、「データブリック・スタイル」が選択されています。
   • 「バケット」リージョン: このフィールドは必須ではありません。
     
     
     
     図iceberg-unity-catalog.pngの説明
     
     

     「追加」をクリックします。

     
     
     
     図manage-unity-catalogs.pngの説明
     
     

   新しいカタログをIcebergカタログに正常にマウントした後、「カタログの管理」ページでUnityカタログを表示できます。このページからカタログを無効にして削除できます。

1. 「カタログ」ツールで、「カタログの選択...」をクリックします。
2. 「カタログおよびスキーマ」ウィザードで「UNITY _CATALOG」フィルタをクリックして、UNITY_CATALOGカタログを表示します。
   
   
   
   図catalogs-schemas-unity-catalog.pngの説明
   
   
3. 「適用」をクリックして、カタログ・ページに結果を表示します。
   
   
   
   図manage-catalogs-unity.pngの説明