Connection

什么是 Connection？

TiDB Cloud Lake 中的 connection 是一种指定配置，用于封装与外部存储服务交互所需的详细信息。它作为一组集中且可复用的参数集合，例如访问凭证、端点 URL 和存储类型，从而便于 TiDB Cloud Lake 与各种存储服务集成。

Connection 可用于创建 external stage、external table 以及 attach table，为通过 TiDB Cloud Lake 管理和访问存储在外部存储服务中的数据提供了一种更简洁、模块化的方法。

Connection 管理

Connection 信息

使用示例

本节中的示例首先创建一个包含连接 Amazon S3 所需凭证的 connection。随后，这些示例使用已建立的 connection 来创建 external stage 并 attach 一个现有表。

以下语句会发起到 Amazon S3 的连接，并指定必要的连接参数：

CREATE CONNECTION toronto
    STORAGE_TYPE = 's3'
    ACCESS_KEY_ID = '<your-access-key-id>'
    SECRET_ACCESS_KEY = '<your-secret-access-key>';

示例 1：使用 Connection 创建 External Stage

以下示例使用前面定义的名为 toronto 的 connection 创建一个 external stage：

CREATE STAGE my_s3_stage
    URL = 's3://lake-toronto'
    CONNECTION = (CONNECTION_NAME = 'toronto');

-- Equivalent to the following statement without using a connection:

CREATE STAGE my_s3_stage
    URL = 's3://lake-toronto'
    CONNECTION = (
        ACCESS_KEY_ID = '<your-access-key-id>',
        SECRET_ACCESS_KEY = '<your-secret-access-key>'
    );

示例 2：使用 Connection Attach Table

ATTACH TABLE 页面提供了示例，演示如何将 TiDB Cloud Lake 中的新表与 TiDB Cloud Lake 中的现有表连接，其中数据存储在名为 "lake-toronto" 的 Amazon S3 存储桶中。在每个示例中，步骤 3 都可以通过使用前面定义的名为 toronto 的 connection 进行简化：

ATTACH TABLE employees_backup
    's3://lake-toronto/1/216/'
    CONNECTION = (CONNECTION_NAME = 'toronto');

ATTACH TABLE population_readonly
    's3://lake-toronto/1/556/'
    CONNECTION = (CONNECTION_NAME = 'toronto')
    READ_ONLY;

示例 3：使用 Connection 创建 External Table

本示例演示如何使用前面定义的名为 toronto 的 connection 创建名为 BOOKS 的 external table：

CREATE TABLE BOOKS (
    id BIGINT UNSIGNED,
    title VARCHAR,
    genre VARCHAR DEFAULT 'General'
)
's3://lake-toronto'
CONNECTION = (CONNECTION_NAME = 'toronto');