Habilitação do fornecimento de credenciais para um catálogo externo¶

Pré-requisitos¶

Antes de executar o comando CLI, você deve atender aos seguintes pré-requisitos para o seu ambiente:

• Python 3.x

• Git

Para executar o comando CLI no Linux ou Mac, siga estas etapas:

1. Clone o repositório GitHub do Apache Polaris™ executando o seguinte comando:

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

   Copy

   Para obter instruções sobre como clonar um repositório GitHub, consulte Clonagem de um repositório.

2. Defina as seguintes variáveis de ambiente para o comando 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

   Onde:

   • sfAccountUrl é a seguinte URL: https://<open_catalog_account_identifier>.snowflakecomputing.com. Para <open_catalog_account_identifier>, especifique o identificador de conta da sua conta do Open Catalog. Dependendo da região e da plataforma de nuvem da conta, esse identificador pode ser o localizador da conta por si só (por exemplo, xy12345) ou incluir segmentos adicionais. Para obter mais informações, consulte Como usar um localizador de conta como um identificador.

   • CLIENT_ID é o client_id da conexão de serviço que você salvou.

   • CLIENT_SECRET é o client_secret da conexão de serviço que você salvou.

   • catalogName é o nome do catálogo externo para o qual você deseja habilitar o fornecimento de credenciais.

3. No diretório em que você clonou o repositório do Apache Polaris, execute o Polaris CLI:

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

   Copy

Pré-requisitos¶

Para executar o código a seguir, você precisa do Docker instalado na máquina Windows.

1. Crie um Dockerfile usando o exemplo de código a seguir:

   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. Na pasta em que o Dockerfile está localizado, crie a imagem do Docker para o Polaris CLI com o seguinte comando:

   % docker build -t polaris-cli .                                                                                                                 0.0s
   

   Copy

3. Execute o contêiner do Docker e o terminal bash com o seguinte comando:

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

   Copy

4. Execute o código a seguir para atualizar o catálogo e definir a propriedade enable.credential.vending como 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. Execute o código a seguir para validar se o parâmetro enable.credential.vending foi configurado corretamente:

   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