Automatische Erzeugung von Anmeldeinformationen für einen externen Katalog aktivieren¶

Voraussetzungen¶

Bevor Sie den CLI-Befehl ausführen, sollten Sie die folgenden Voraussetzungen für Ihre Umgebung erfüllen:

• Python 3.x

• Git

Um den CLI-Befehl unter Linux oder Mac auszuführen, gehen Sie wie folgt vor:

1. Klonen Sie das Apache Polaris™ GitHub-Repository, indem Sie den folgenden Befehl ausführen:

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

   Copy

   Anweisungen zum Klonen eines GitHub-Repositorys finden Sie unter Klonen eines Repositorys.

2. Definieren Sie die folgenden Umgebungsvariablen für den CLI-Befehl:

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

   Copy

   Wobei:

   • sfAccountUrl die folgende URL ist: https://<open_catalog_account_identifier>.snowflakecomputing.com. Für <open_catalog_account_identifier> geben Sie den Kontobezeichner für Ihr Open Catalog-Konto an. Je nach Region und Cloud-Plattform für das Konto kann dieser Bezeichner der Konto-Locator selbst sein (zum Beispiel xy12345) oder zusätzliche Segmente enthalten. Weitere Informationen finden Sie unter Einen Konto-Locator als Bezeichner verwenden.

   • CLIENT_ID ist die client_id für Ihre Dienstverbindung, die Sie gespeichert haben.

   • CLIENT_SECRET ist das client_secret für Ihre Serviceverbindung, das Sie gespeichert haben.

   • catalogName ist der Name des externen Katalogs, für den Sie die automatische Erzeugung von Anmeldeinformationen aktivieren möchten.

3. Führen Sie in dem Verzeichnis, in das Sie das Apache Polaris-Repository geklont haben, das Polaris-CLI aus:

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

   Copy

Voraussetzungen¶

Um den folgenden Code auszuführen, müssen Sie Docker auf dem Windows-Computer installieren.

1. Erstellen Sie eine Dockerdatei anhand des folgenden Codebeispiels:

   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
   

   Copy

2. Erstellen Sie in dem Ordner, in dem sich die Dockerdatei befindet, das Docker-Image für Polaris-CLI mit dem folgenden Befehl:

   % docker build -t polaris-cli .                                                                                                                 0.0s
   

   Copy

3. Starten Sie den Docker-Container und das Bash-Terminal mit dem folgenden Befehl:

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

   Copy

4. Führen Sie den folgenden Code aus, um den Katalog zu aktualisieren und die Eigenschaft enable.credential.vending auf true zu setzen:

   % 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"
   

   Copy

5. Führen Sie den folgenden Code aus, um zu überprüfen, ob der Parameter enable.credential.vending korrekt konfiguriert wurde:

   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>"}}
   

   Copy