Connection

什么是 Connection？

Databend 中的 Connection 是指一种指定的配置，它封装了与外部存储服务交互所需的详细信息。它作为一个集中且可重用的参数集，例如访问凭据、端点 URL 和存储类型，从而方便 Databend 与各种存储服务的集成。

Connection 可用于创建外部 Stage、外部表和附加表，从而提供了一种简化的模块化方法来管理和访问存储在外部存储服务中并通过 Databend 访问的数据。有关示例，请参见 使用示例。

管理 Connection

要管理 Databend 中的 Connection，请使用以下命令：

使用示例

本节中的示例首先创建一个 Connection，其中包含连接到 Amazon S3 所需的凭据。 随后，它们利用此已建立的 Connection 来创建外部 Stage 并附加现有表。

此语句启动与 Amazon S3 的 Connection，指定必要的 Connection 参数：

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

示例 1：使用 Connection 创建外部 Stage

以下示例使用先前定义的名为“toronto”的 Connection 创建一个外部 Stage：

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


-- 相当于以下不使用 Connection 的语句：

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：使用 Connection 附加表

ATTACH TABLE 页面提供了示例，演示了如何将 Databend Cloud 中的新表与 Databend 中的现有表连接起来，其中数据存储在名为“databend-toronto”的 Amazon S3 bucket 中。 在每个示例中，可以使用先前定义的名为“toronto”的 Connection 来简化步骤 3：

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：使用 Connection 创建外部表

此示例演示如何使用先前定义的名为“toronto”的 Connection 创建名为“BOOKS”的外部表：

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