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

시작하기 전에¶

Open Catalog용 Snowflake CLI 연결을 생성하려면 전체 Open Catalog 계정 식별자가 필요합니다. 계정 식별자에는 Snowflake 조직 이름과 Open Catalog 계정 이름이 포함됩니다. 예를 들어, <orgname> 또는<my-snowflake-open-catalog-account-name>입니다.

• Snowflake 조직 이름(<orgname>)을 확인하려면 계정의 조직 및 계정 이름 찾기<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 테이블을 저장하는 경우, 계정에 대해 2개의 비공개 연결 엔드포인트를 프로비저닝해야 합니다. 자세한 내용은 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 Storage를 사용하여 카탈로그 만들기의 지침을 따릅니다. 카탈로그에 대해 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 지원에 문의하세요.