外部カタログの認証情報供給を有効にする¶

前提条件¶

CLI コマンドを実行する前に、お使いの環境に関する以下の前提条件を満たしている必要があります。

• Python 3.x

• Git

Linux または Mac で CLI コマンドを実行するには、以下の手順に従います。

1. 以下のコマンドを実行して、Apache Polaris™ GitHub リポジトリをクローンします。

   CopyExpand

   git clone https://github.com/apache/polaris.git
   

   Show lessSee more

   Scroll to top

   GitHub リポジトリをクローンする方法については、リポジトリのクローニング を参照してください。

2. CLI コマンド用に以下の環境変数を定義します。

   CopyExpand

   export CLIENT_ID=<client-id>
   export CLIENT_SECRET=<client-secret>
   export sfAccountUrl=https://<open_catalog_account_identifier>.snowflakecomputing.com
   export catalogName=<my-catalog>
   

   Show lessSee more

   Scroll to top

   条件:

   • sfAccountUrl は次のとおりです。URL: https://<open_catalog_account_identifier>.snowflakecomputing.com``<open_catalog_account_identifier> の場合は、オープンカタログアカウントのアカウント識別子を指定します。アカウントのリージョンやクラウドプラットフォームによっては、この識別子はそれ自体がアカウントのロケータになることもあれば（例えば、 xy12345）、追加のセグメントを含むこともあります。詳細については、識別子としてのアカウントロケーターの使用をご参照ください。

   • CLIENT_ID は保存したサービス接続のclient_idです。

   • CLIENT_SECRET は保存したサービス接続のclient_secretです。

   • catalogName は、認証情報ベンディングを有効にする外部カタログの名前です。

3. Apache Polarisレポをクローンしたディレクトリから、Polaris CLI を実行します。

   CopyExpand

   ./polaris \
     --base-url "${sfAccountUrl}/polaris" \
     --client-id ${CLIENT_ID} \
     --client-secret ${CLIENT_SECRET} \
     catalogs \
     update "${catalogName}" \
     --set-property "enable.credential.vending"="true"
   

   Show lessSee more

   Scroll to top

前提条件¶

以下のコードを実行するには、WindowsマシンにDockerがインストールされている必要があります。

1. 以下のコード例を使ってDockerfileを作成します。

   CopyExpand

   FROM python:3.11
   
   # install git
   RUN apt-get update && apt-get install -y git
   
   # get polaris
   RUN git clone https://github.com/apache/polaris.git
   
   WORKDIR /polaris
   
   RUN pip install --upgrade pip
   
   # install polaris cli
   RUN ./polaris --help
   

   Show lessSee more

   Scroll to top

2. Dockerfileがあるフォルダから、以下のコマンドでPolaris CLI 用のdockerイメージをビルドします。

   CopyExpand

   % docker build -t polaris-cli .                                                                                                                 0.0s
   

   Show lessSee more

   Scroll to top

3. dockerコンテナーを起動し、bashターミナルで以下のコマンドを実行します。

   CopyExpand

   % docker run --rm -it polaris-cli /bin/bash
   root@ae4c8353b45f:/polaris# 
   

   Show lessSee more

   Scroll to top

4. 以下のコードを実行してカタログを更新し、プロパティ enable.credential.vending を true にセットします。

   CopyExpand

   % docker run --rm -it polaris-cli /bin/bash
   root@ae4c8353b45f:/polaris# export CLIENT_ID=<client-id>
   export CLIENT_SECRET=<client-secret>
   export sfAccountUrl=https://<open_catalog_account_identifier>.snowflakecomputing.com
   export catalogName=<my-catalog>
   root@ae4c8353b45f:/polaris# ./polaris \
     --base-url "${sfAccountUrl}/polaris" \
     --client-id ${CLIENT_ID} \
     --client-secret ${CLIENT_SECRET} \
     catalogs \
     update "${catalogName}" \
     --set-property "enable.credential.vending"="true"
   

   Show lessSee more

   Scroll to top

5. 以下のコードを実行して、パラメーター enable.credential.vending が正しく構成されていることを確認します。

   CopyExpand

   root@ae4c8353b45f:/polaris# ./polaris \
     --base-url "${sfAccountUrl}/polaris" \
     --client-id ${CLIENT_ID} \
     --client-secret ${CLIENT_SECRET} \
     catalogs \
     get "${catalogName}"
   {"type": "EXTERNAL", "name": "<my-catalog>", "properties": {"default-base-location": "s3://<bucket-name>/polaris/my-catalog-v2-storage/", "enable.credential.vending": "true"}, "createTimestamp": 1722547448827, "lastUpdateTimestamp": 1730906335286, "entityVersion": 3, "storageConfigInfo": {"storageType": "S3", "allowedLocations": ["s3://<bucket-name>/polaris/my-catalog-v2-storage/"], "roleArn": "arn:aws:iam::<aws-account-id>:role/<polaris-aws-role>"}}
   

   Show lessSee more

   Scroll to top