Activer la distribution d’identifiants de connexion pour un catalogue externe¶

Conditions préalables¶

Avant d’exécuter la commande CLI, vous devez remplir les conditions préalables suivantes pour votre environnement :

• [Python 3.x] (https://www.python.org/downloads/)

• [Git] (https://git-scm.com/)

Pour exécuter la commande CLI sous Linux ou Mac, procédez comme suit :

1. Clonez le référentiel Apache Polaris™ GitHub en exécutant la commande suivante :

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

   Copy

   Pour obtenir des instructions sur la manière de cloner un référentiel GitHub, consultez [Clonage d’un référentiel] (https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository).

2. Définissez les variables d’environnement suivantes pour la commande CLI :

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

   Copy

   Où :

   • sfAccountUrl est l’URL suivante : https://<identificateur-compte_open_catalog>.snowflakecomputing.com. Pour <open_catalog_account_identifier>, indiquez l’identificateur de compte de votre compte Open Catalog. En fonction de la région et de la plateforme Cloud du compte, cet identificateur peut être le localisateur de compte à lui seul (par exemple, xy12345) ou inclure des segments supplémentaires. Pour plus d’informations, voir Utilisation d’un localisateur de compte comme identificateur.

   • CLIENT_ID est l’identifiant du client de votre connexion de service que vous avez sauvegardé.

   • CLIENT_SECRET est le secret du client de votre connexion de service que vous avez sauvegardé.

   • catalogName est le nom du catalogue externe pour lequel vous souhaitez activer la distribution d’identifiants.

3. Depuis le répertoire dans lequel vous avez cloné le repo Apache Polaris, exécutez la CLI de Polaris :

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

   Copy

Conditions préalables¶

Pour exécuter le code suivant, il faut que Docker soit installé sur la machine Windows.

1. Créez un Dockerfile en utilisant l’exemple de code suivant :

   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. À partir du dossier où se trouve le Dockerfile, construisez l’image docker pour la CLI de Polaris à l’aide de la commande suivante :

   % docker build -t polaris-cli .                                                                                                                 0.0s
   

   Copy

3. Exécutez le conteneur Docker et le terminal bash avec la commande suivante :

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

   Copy

4. Exécutez le code suivant pour mettre à jour le catalogue afin de définir la propriété enable.credential.vending sur true :

   % 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. Exécutez le code suivant pour valider que le paramètre enable.credential.vending a été configuré correctement :

   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