连接到账户

本主题提供了用于连接到组织中的 Snowflake 账户的 URL 和 账户标识符 格式。

备注

如果您是组织管理员，并且想要为已更改的账户删除旧的 URLs，请参阅 管理账户 URLs。

本主题内容：

连接到 Snowflake Web 界面

要使用 Web 浏览器连接到 Snowsight，请参阅 登录 Snowsight。

与 URL 连接

Snowflake 支持多种 URL 格式，无需浏览器即可连接到 Snowflake 账户。例如，身份提供商可能会使用直接 URL 与 Snowflake 通信。

  • 账户名称 格式通过账户的名称及其 组织 来识别账户。要查找组织和账户的名称，请参阅 查找账户的组织和账户名称。

  • 使用 Client Redirect 功能时，需要 连接名称 格式，该格式将账户名称替换为连接名称。要查找连接名称，请执行 SHOW CONNECTIONS 命令。

  • 目前支持旧版 账户定位器 格式，但不鼓励使用它。

标准账户 URLs

标准 URL 格式可用于大多数需要 Snowflake账户 URL 的情况，包括：

  • SSO 连接（Okta 除外）

  • SCIM 基础 URL（Okta 除外）

  • OAuth 与第三方身份提供商的连接（Okta 除外）

  • OAuth 基础 URL 用于 Snowflake 授权服务器

标准 URL 格式包括：

  • 账户名称： https://<orgname>-<account_name>.snowflakecomputing.cn

  • 连接名称： https://<orgname>-<connectionname>.snowflakecomputing.cn

  • 账户定位器（旧版）：https://<accountlocator>.<region>.<cloud>.snowflakecomputing.cn

专用连接 URLs

使用 Snowflake 服务的专用连接（例如 AWS PrivateLink)连接到 Snowflake 时，字符串 privatelink 必须追加到 Snowflake 账户 URL 中的 账户标识符。

  • 账户名称： https://<orgname>-<account_name>.privatelink.snowflakecomputing.cn

  • 连接名称： https://<orgname>-<connectionname>.privatelink.snowflakecomputing.cn

  • 账户定位器（旧版）： https://<account_locator>.<region>.privatelink.snowflakecomputing.cn

请注意，要使用专用连接，需要更新 DNS 记录，使其包含专用连接 URL。有关更多信息，请参阅：

Okta URLs

将 Okta 用于 SSO、SCIM 或 OAuth 时，如果账户名称包含下划线，则必须使用特殊的账户名称格式。因为 Okta 不支持 URLs 中的下划线，账户名称中的下划线必须转换为连字符。

  • 账户名称： https://<orgname>-<account-name>.snowflakecomputing.cn

  • 连接名称：使用标准 URL

  • 账户定位器（旧版）：使用标准 URL

与客户端、连接器和驱动程序连接

客户端、连接器和驱动程序使用各种语法来连接到 Snowflake。一般来说，应该使用包含组织名称 (orgname) 和账户名称 (account_name) 的变体，但以下情况除外：

  • 如果使用 Client Redirect 功能，请将账户名称 (account_name) 替换为连接名称 (connection_name)。有关此语法的示例，请参阅 使用连接 URL。

  • 目前，不支持使用账户名称格式与 Snowflake 服务进行专用连接。作为解决方法，将 privatelink 追加到账户定位器语法。要验证使用专用连接时，应使用哪个值连接到 Snowflake，请调用 Snowflake 账户中的 SYSTEM$GET_PRIVATELINK_CONFIG 功能。

SnowSQL:

  • 账户名称： snowsql -a <orgname>-<account_name>

  • 账户定位器： snowsql -a <account_locator>

JDBC:

  • 账户名称： jdbc:snowflake://<orgname>-<account_name>.snowflakecomputing.cn/?<connection_params>

  • 账户定位器： jdbc:snowflake://<account_locator>.snowflakecomputing.cn/?<connection_params>

ODBC:

  • 账户名称：

    • 服务器： <orgname>-<account_name>.snowflakecomputing.cn

  • 账户定位器：

    • 服务器： <account_locator>.snowflakecomputing.cn

Python:

  • 账户名称：

    • 将 ACCOUNT 参数值设置为 <orgname>-<account_name>。

  • 账户定位器：

    • 将 ACCOUNT 参数值设置为 <account_locator>.<region_id>.<cloud>。

.Net:

  • 账户名称：

    • 将 ACCOUNT 参数值设置为 <orgname>-<account_name>。

    • 将 HOST 参数值设置为默认值 (.snowflakecomputing.cn)。

  • 账户定位器：

    • 将 ACCOUNT 参数值设置为 <account_locator>。

    • 将 HOST 参数值设置为默认值 .snowflakecomputing.cn。指定 Snowflake 账户是否不在 us-west 区域。

Golang:

  • 账户名称： db, err := sql.Open("snowflake", "jsmith:mypassword@<orgname>-<account_name>/mydb/testschema?warehouse=mywh")

  • 账户定位器： sql.Open("snowflake", "jsmith:mypassword@<account_locator>/mydb/testschema?warehouse=mywh")

node.js:

  • 账户名称：将 ACCOUNT 参数值设置为 <orgname>-<account_name>。

  • 账户定位器：将 ACCOUNT 参数值设置为 <account_locator>.<region_id>.<cloud>。

Spark（连接器）:

  • 账户名称：与 JDBC 相同

  • 账户定位器：与 JDBC 相同

Spark（数据块）:

  • 账户名称： <Account URL for Snowflake account>

  • 账户定位器： <Account Locator URL for Snowflake account>

Spark (Qubole):

  • 账户名称：将 Host Address 字段值设置为 <orgname>-<account_name>.snowflakecomputing.cn。

  • 账户定位器：将 Host Address 字段值设置为 <account_locator>.snowflakecomputing.cn。

PHP:

  • 账户名称：

    • 将 ACCOUNT 参数值设置为 <orgname>-<account_name>。

    • 将所有区域的 REGION 参数值留空。

  • 账户定位器：

    • 将 ACCOUNT 参数值设置为 <account_locator>。

    • 如果 Snowflake 账户 不 在 us-west 区域，请设置 REGION 参数值。

SQLAchemy:

  • 账户名称： snowflake://<user_login_name>:<password>@<orgname>-<account_name>

  • 账户定位器：snowflake://<user_login_name>:<password>@<account_locator>.<region_id>.<cloud>

向后兼容性

仍然支持在账户标识符或账户 URL 中使用旧版账户定位器，但不鼓励使用。

语言: 中文