连接（CONNECTION）

什么是连接？

在 Databend 中，连接（CONNECTION）指的是封装了与外部存储服务交互所需细节的指定配置。它作为一组集中和可重用的参数，如访问凭证、端点 URL 和存储类型，促进了 Databend 与各种存储服务的集成。

连接可用于创建外部 Stage、外部表和附加表，为 Databend 管理和访问存储在外部存储服务中的数据提供了一种流线型和模块化的方法。请参见 使用示例 了解详情。

管理连接

要在 Databend 中管理连接，请使用以下命令：

使用示例

本节中的示例先创建了一个连接，其中包含连接到 Amazon S3 所需的凭证。随后，它们利用这个连接来创建一个外部 Stage 并将数据附到一个现存的表中。

此语句启动到 Amazon S3 的连接，指定必要的连接参数：

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

示例 1：使用连接创建外部 Stage

以下示例使用之前定义的名为'toronto'的连接创建一个外部 Stage：

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


-- 等同于以下未使用连接的语句：
CREATE STAGE my_s3_stage
    URL = 's3://databend-toronto'
    CONNECTION = (
        SECRET_ACCESS_KEY = '<your-secret-access-key>'
        ACCESS_KEY_ID = '<your-access-key-id>'
    );

示例 2：在附加表中使用连接

ATTACH TABLE页面提供了示例，演示了如何在 Databend Cloud 中将一个新表与 Databend 中的现有表进行连接，其中数据存储在名为 "databend-toronto" 的 Amazon S3 桶中。在这个示例中，步骤 3 可以使用之前定义的名为 'toronto' 的连接来简化：

Databend Cloud:

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

Databend Cloud:

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

示例 3：使用连接创建外部表

此示例演示了使用之前定义的名为 'toronto' 的连接创建名为 'BOOKS' 的外部表：

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