Snowflake Open Catalog에 대한 비공개 연결 엔드포인트 관리: Azure¶

시작하기 전에¶

Open Catalog에 대한 Snowflake CLI 연결을 만들려면 전체 Open Catalog 계정 식별자가 필요합니다. 계정 식별자에는 Snowflake 조직 이름과 Open Catalog 계정 이름이 포함됩니다(예: <orgname>.<my-snowflake-open-catalog-account-name>).

• Snowflake 조직 이름(<조직 이름>)을 찾으려면 계정의 조직 및 계정 이름 찾기 <https://docs.snowflake.com/en/user-guide/admin-account-identifier.html#label-account-name-find>_ 섹션을 참조하십시오.

• Snowflake Open Catalog 계정 이름(<my-snowflake-open-catalog-account-name>)을 찾으려면 Snowflake Open Catalog 계정 이름 찾기 <https://other-docs.snowflake.com/en/opencatalog/find-account-name>_ 섹션을 참조하십시오.

Snowflake Open Catalog에 대한 Snowflake CLI 연결 추가하기¶

비공개 연결을 사용하도록 설정하려는 Snowflake Open Catalog 계정에 대한 연결을 추가합니다.

• 다음 값으로 연결을 추가합니다. <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ 다른 모든 매개 변수의 경우 Enter 키를 눌러 매개 변수 값 지정을 건너뛰십시오.

  연결 구성 매개 변수	값
  이 연결의 이름	연결 이름을 지정합니다(예: myopencatalogconnection).
  계정 이름	이 형식에 따라 Snowflake 조직 이름과 Open Catalog 계정 이름을 지정합니다. <orgname>-<my-snowflake-open-catalog-account-name>. 예: ABCDEFG-MYACCOUNT1. 이러한 이름을 찾으려면 시작하기 전에_ 섹션을 참조하십시오.
  사용자 이름	Open Catalog의 사용자 이름을 지정합니다(예: jsmith).
  비밀번호[선택 사항]	이 매개 변수는 Open Catalog 연결을 생성할 때 선택 사항이 아닙니다. Open Catalog 비밀번호를 입력합니다(예: MyPassword123456789).
  연결의 역할[선택 사항]	이 매개 변수는 Open Catalog 연결을 생성할 때 선택 사항이 아닙니다. POLARIS_ACCOUNT_ADMIN 을 입력해야 합니다.

Snowflake CLI 연결 테스트하기¶

• CLI 연결을 테스트하려면 myopencatalogconnection 에 대한 연결을 테스트하는 이 예제를 따르십시오.

  snow connection test -c myopencatalogconnection
  

  Copy

  응답은 다음과 같이 표시되어야 합니다.

  +------------------------------------------------------------------------------+
  | key              | value                                                     |
  |----------------------------+-------------------------------------------------|
  | Connection name  | myopencatalogconnection                                   |
  | Status           | OK                                                        |
  | Host             | ABCDEFG-MYACCOUNT1.snowflakecomputing.com                 |
  | Account          | ABCDEFG-MYACCOUNT1                                        |
  | User             | jsmith                                                    |
  | Role             | POLARIS_ACCOUNT_ADMIN                                     |
  | Database         | not set                                                   |
  | Warehouse        | not set                                                   |
  +------------------------------------------------------------------------------+
  

  Copy

Snowflake Open Catalog에 대해 Snowflake CLI 연결을 기본값으로 설정하기¶

사용 중인 연결에 항상 요구 사항인 POLARIS_ACCOUNT_ADMIN 역할이 부여되도록 하려면 Open Catalog용으로 생성한 Snowflake CLI 연결을 기본 연결로 설정할 수 있습니다. 기본 연결에 대한 자세한 내용은 기본 연결 설정하기 <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_ 섹션을 참조하십시오.

1. myopencatalogconnection 연결을 기본값으로 설정하는 이 예시를 따르십시오.

   snow connection set-default myopencatalogconnection
   

   Copy

2. 올바른 사용자와 역할을 사용하고 있는지 확인하려면 다음을 실행합니다.

   snow sql -q "Select current_user(); select current_role();"
   

   Copy

   응답은 Open Catalog 사용자 이름을 반환해야 하며 CURRENT ROLE 은 POLARIS_ACCOUNT_ADMIN 이어야 합니다.

   +----------------+
   | CURRENT_USER() |
   |----------------|
   | JSMITH        |
   +----------------+
   select current_role();
   +-----------------------+
   | CURRENT_ROLE()        |
   |-----------------------|
   | POLARIS_ACCOUNT_ADMIN |
   +-----------------------+
   

   Copy

예: Data Lake Storage 저장소 계정에 대한 비공개 연결 엔드포인트 프로비저닝하기¶

Data Lake Storage 계정을 사용하여 Iceberg 테이블을 저장하는 경우, 계정에 대해 두 개의 비공개 연결 엔드포인트를 프로비저닝해야 합니다. 자세한 내용은 Azure 설명서에서 비공개 엔드포인트 만들기 섹션을 참조하십시오.

예:

엔드포인트 blob을 위한 비공개 엔드포인트 프로비저닝하기

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
'/subscriptions/mysubscriptionid/resourceGroups/mystorage/providers/Microsoft.Storage/storageAccounts/storagedemo',
  'storagedemo.blob.core.windows.net',
  'blob'
);

DFS 엔드포인트에 대한 비공개 엔드포인트 프로비저닝하기

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
'/subscriptions/mysubscriptionid/resourceGroups/mystorage/providers/Microsoft.Storage/storageAccounts/storagedemo',
  'storagedemo.dfs.core.windows.net',
  'dfs'
);

새 카탈로그에 비공개 연결 활성화하기¶

Azure 저장소를 사용하여 카탈로그 만들기의 지침을 따르십시오. 카탈로그의 경우 Private Link 토글이 활성화되어 있는지 확인합니다.

기존 카탈로그에 비공개 연결 활성화하기¶

1. Open Catalog에 로그인합니다.

2. 탐색 메뉴에서 카탈로그 를 선택합니다.

3. 카탈로그 목록에서 비공개 연결을 활성화할 카탈로그를 선택합니다.

4. 카탈로그 세부 정보 탭에서 PrivateLink 토글을 활성화됨 으로 설정합니다.

Open Catalog에서 테이블의 스키마를 볼 수 없음¶

증상

Open Catalog에서 카탈로그의 테이블(예: catalog1)을 선택하지만 다음과 같은 오류 메시지가 표시됩니다. “No permissions to access this resource.”

원인

Azure에서 VPC 엔드포인트를 통해 네트워크 트래픽을 라우팅하도록 저장소 계정에 대한 네트워크 설정을 성공적으로 업데이트했습니다. 그러나 Open Catalog에서는 이 카탈로그에 대해 비공개 연결을 활성화하지 않았으므로 Open Catalog에서 버킷에 액세스할 수 없습니다.

해결책

카탈로그에 비공개 연결을 활성화합니다(예: catalog1). 자세한 내용은 카탈로그에 비공개 연결 활성화하기 섹션을 참조하십시오.

쿼리 엔진에서 “Failed to get subscoped credentials” 오류 메시지 수신¶

증상

쿼리 엔진을 사용하여 테이블에 데이터를 읽거나 쓰려고 하는데 다음과 같은 오류 메시지가 표시됩니다. “Failed to get subscoped credentials.”

원인

저장소 계정을 잠갔지만 비공개 연결 엔드포인트를 프로비저닝하거나 Open Catalog 계정에서 비공개 연결을 활성화하지 않았습니다. 결과적으로 Open Catalog는 하위 범위의 자격 증명을 생성하여 쿼리 엔진에 반환할 수 없으므로 쿼리 엔진이 저장소에 액세스할 수 없습니다.

해결책

다음 단계를 따르십시오.

• 아직 비공개 연결 엔드포인트를 프로비저닝하지 않았다면 저장소 계정에 대한 비공개 연결 엔드포인트 프로비저닝하기 섹션을 참조하십시오.

• 아직 카탈로그에 대한 비공개 연결을 활성화하지 않았다면 카탈로그에 비공개 연결을 활성화하십시오.

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 명령 실행 시 ‘Business Critical’ 오류 발생¶

증상

Snowflake CLI 연결에서 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 명령을 실행했지만 다음 오류 메시지와 함께 실패합니다. “Business Critical or higher edition is required for this operation. Please upgrade to the valid edition and then retry.”

원인

Open Catalog 계정의 에디션이 Business Critical이 아닙니다.

비공개 연결 엔드포인트 프로비저닝을 포함하여 아웃바운드 네트워크 트래픽에 대해 비공개 연결을 사용하려면 Snowflake Open Catalog 계정의 에디션 이 Business Critical이어야 합니다.

해결책

Open Catalog 계정을 Business Critical으로 업그레이드하는 데 도움이 필요하면 Snowflake 지원팀 에 문의하십시오.