외부 카탈로그에 대한 자격 증명 제공 활성화하기¶

전제 조건¶

CLI 명령을 실행하기 전에 사용 중인 환경에 맞는 다음 전제 조건을 충족해야 합니다.

• Python 3.x

• Git

Linux 또는 Mac에서 CLI 명령을 실행하려면 다음 단계를 따르십시오.

1. 다음 명령을 실행하여 Apache Polaris™ GitHub 리포지토리를 복제합니다.

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

   Copy

   GitHub 리포지토리를 복제하는 방법에 대한 지침은 리포지토리 복제를 참조하십시오.

2. 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

   여기서:

   • 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 Polari 리포지토리를 복제본으로 생성한 디렉터리에서 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

전제 조건¶

다음 코드를 실행하려면 Windows 머신에 Docker가 설치 관리자가 필요합니다.

1. 다음 코드 예제를 사용하여 Docker 파일을 만듭니다.

   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. Docker파일이 위치한 폴더에서 다음 명령을 사용하여 Polaris CLI 에 대한 도커 이미지를 빌드합니다.

   % docker build -t polaris-cli .                                                                                                                 0.0s
   

   Copy

3. 다음 명령어로 도커 컨테이너와 bash 터미널을 실행합니다.

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

   Copy

4. 다음 코드를 실행해 카탈로그를 업데이트하여 enable.credential.vending 속성을 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. 다음 코드를 실행하여 enable.credential.vending 매개 변수가 올바르게 구성되었는지 확인합니다.

   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