Gerenciamento de pontos de extremidade de conectividade privada para Snowflake Open Catalog: AWS¶

Antes de começar¶

Para criar uma conexão do Snowflake CLI para o Open Catalog, você precisa do identificador completo da sua conta do Open Catalog. O identificador da conta inclui o nome da organização Snowflake e o nome da conta do Open Catalog, por exemplo, <orgname>.<my-snowflake-open-catalog-account-name>.

• Para encontrar o nome da sua organização Snowflake (<orgname>), consulte Como encontrar o nome da conta e organização de uma conta <https://docs.snowflake.com/en/user-guide/admin-account-identifier.html#label-account-name-find>_.

• Para encontrar o nome da sua conta do Snowflake Open Catalog (<my-snowflake-open-catalog-account-name>), consulte Encontrar o nome de uma conta do Snowflake Open Catalog <https://other-docs.snowflake.com/en/opencatalog/find-account-name>_.

Adição da conexão do Snowflake CLI para Snowflake Open Catalog¶

Adicione uma conexão para a conta do Snowflake Open Catalog em que você quer habilitar a conectividade privada.

• Adicione uma conexão <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection>_ com os valores a seguir. Para todos os outros parâmetros, pressione Enter para ignorar a especificação de um valor para o parâmetro.

  Parâmetros de configuração da conexão	Valor
  Nome desta conexão	Especifique um nome para a conexão, por exemplo, myopencatalogconnection.
  Nome da conta	Especifique o nome da sua organização Snowflake, seguido do nome da sua conta do Open Catalog, neste formato: <orgname>-<my-snowflake-open-catalog-account-name>. Por exemplo, ABCDEFG-MYACCOUNT1. Para encontrar esses nomes, consulte Antes de começar_.
  Nome de usuário	Especifique seu nome de usuário do Open Catalog, por exemplo, jsmith.
  Senha [opcional]	Esse parâmetro não é opcional quando você cria uma conexão para o Open Catalog. Digite sua senha do Open Catalog, por exemplo, MyPassword123456789.
  Função para a conexão [opcional]	Esse parâmetro não é opcional quando você cria uma conexão para o Open Catalog. Você deve inserir POLARIS_ACCOUNT_ADMIN.

Teste da conexão do Snowflake CLI¶

• Para testar a conexão do CLI, siga este exemplo, que testa a conexão para myopencatalogconnection:

  snow connection test -c myopencatalogconnection
  

  Copy

  A resposta deve ser assim:

  +------------------------------------------------------------------------------+
  | 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

Configuração da conexão do Snowflake CLI para Snowflake Open Catalog como padrão¶

Para garantir que a conexão que você sempre usa tenha a função POLARIS_ACCOUNT_ADMIN necessária, defina a conexão do Snowflake CLI que você criou para o Open Catalog como padrão. Para obter mais informações sobre a conexão padrão, consulte Definição da conexão padrão <https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#set-the-default-connection>_.

1. Siga este exemplo, que define a conexão myopencatalogconnection como padrão:

   snow connection set-default myopencatalogconnection
   

   Copy

2. Para confirmar se você está usando o usuário e a função corretos, execute o seguinte:

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

   Copy

   A resposta deve retornar seu nome de usuário do Open Catalog e a CURRENT ROLE deve ser POLARIS_ACCOUNT_ADMIN.

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

   Copy

Exemplo: Provisionamento de ponto de extremidade de conectividade privada¶

O exemplo a seguir cria um PrivateLink com acesso externo ao Amazon S3 para configurar um ponto de extremidade para a região us-west-2:

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  'com.amazonaws.us-west-2.s3',
  '*.s3.us-west-2.amazonaws.com'
);

Habilitação da conectividade privada para um novo catálogo¶

Siga as instruções em Criação de um catálogo usando o Amazon Simple Storage Service (Amazon S3). Certifique-se de que, para o catálogo, o botão de alternância Private Link esteja habilitado.

Habilitação da conectividade privada para um catálogo existente¶

1. Entre no Open Catalog.

2. No menu de navegação, selecione Catalogs.

3. Na lista de catálogos, selecione aquele no qual você quer habilitar a conectividade privada.

4. Na guia Catalog Details, defina o botão de alternância PrivateLink como Enabled.