管理 Snowflake Open Catalog 的专用连接端点：AWS¶

准备工作¶

要为 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 键跳过指定参数值。

  连接配置参数	值
  Name for this connection	指定连接名称，例如 myopencatalogconnection。
  Account name	按如下格式指定您的 Snowflake 组织名称，后接您的 Open Catalog 账户名称： <orgname>-<my-snowflake-open-catalog-account-name>。 例如 ABCDEFG-MYACCOUNT1。 要查找这些名称，请参阅 准备工作_。
  Username	指定您的 Open Catalog 用户名；例如，jsmith。
  Password [optional]	为 Open Catalog 创建连接时，该参数 不是 可选参数。 输入您的 Open Catalog 密码；例如，MyPassword123456789。
  Role for the connection [optional]	为 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.cn                 |
  | 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

示例：提供专用连接端点¶

以下示例创建了一个具有 Amazon S3 外部访问权限的 PrivateLink，以便为 us-west-2 区域设置端点：

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

为新目录启用专用连接¶

按照 使用 Amazon Simple Storage Service (Amazon S3) 创建目录 中的说明进行操作。 确保目录的 Private Link 开关处于 Enabled 状态。

为现有目录启用专用连接¶

1. 登录 Open Catalog。

2. 在导航菜单中，选择 Catalogs。

3. 在目录列表中，选择您要启用专用连接的目录。

4. 在 Catalog Details 选项卡上，将 PrivateLink 开关设置为 Enabled。