📣

TiDB Cloud Premium 开放公测中。为企业级工作负载提供无限扩展、即时弹性伸缩和高级安全保障。此页面由 AI 自动翻译，英文原文请见此处。

从 Stage 加载

TiDB Cloud Lake 使你能够轻松地从上传到用户 stage 或内部/外部 stage 的文件中导入数据。为此，你可以先使用 LakeSQL 将文件上传到 stage，然后使用 COPY INTO 命令从 stage 中的文件加载数据。请注意，文件必须采用 TiDB Cloud Lake 支持的格式，否则无法导入数据。有关 TiDB Cloud Lake 支持的文件格式的更多信息，请参见输入与输出文件格式。

以下教程提供了详细的分步指南，帮助你顺利完成从 stage 中的文件加载数据的过程。

开始之前

开始之前，请确保你已完成以下任务：

下载示例文件 books.parquet 并将其保存到本地文件夹中。该文件包含两条记录：

Transaction Processing,Jim Gray,1992
Readings in Database Systems,Michael Stonebraker,2004

在 TiDB Cloud Lake 中使用以下 SQL 语句创建表：

USE default;
CREATE TABLE books
(
    title VARCHAR,
    author VARCHAR,
    date VARCHAR
);

教程 1：从用户 stage 加载

按照本教程将示例文件上传到用户 stage，并将 stage 中文件的数据加载到 TiDB Cloud Lake 中。

步骤 1. 上传示例文件

使用 LakeSQL 上传示例文件：

root@localhost:8000/default> PUT fs:///Users/eric/Documents/books.parquet @~

┌───────────────────────────────────────────────┐
│                 file                │  status │
│                String               │  String │
├─────────────────────────────────────┼─────────┤
│ /Users/eric/Documents/books.parquet │ SUCCESS │
└───────────────────────────────────────────────┘

验证 stage 中的文件：

LIST @~;

name         |size|md5                               |last_modified                |creator|
-------------+----+----------------------------------+-----------------------------+-------+
books.parquet| 998|"88432bf90aadb79073682988b39d461c"|2023-06-27 16:03:51.000 +0000|       |

步骤 2. 将数据复制到表中

使用 COPY INTO 命令将数据加载到目标表中：

COPY INTO books FROM @~ files=('books.parquet') FILE_FORMAT = (TYPE = PARQUET);

验证已加载的数据：

SELECT * FROM books;

---
title                       |author             |date|
----------------------------+-------------------+----+
Transaction Processing      |Jim Gray           |1992|
Readings in Database Systems|Michael Stonebraker|2004|

教程 2：从内部 stage 加载

按照本教程将示例文件上传到内部 stage，并将 stage 中文件的数据加载到 TiDB Cloud Lake 中。

步骤 1. 创建内部 stage

使用 CREATE STAGE 命令创建内部 stage：
```
CREATE STAGE my_internal_stage;
```

验证已创建的 stage：

SHOW STAGES;

╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│        name       │ stage_type │   storage_type   │        url       │     endpoint     │ has_credentials │   has_encryption_key  │   storage_params  │  file_format_options │      creator     │  created_on │ comment │       owner      │
│       String      │   String   │ Nullable(String) │ Nullable(String) │ Nullable(String) │     Boolean     │        Boolean        │ Nullable(Variant) │        Variant       │ Nullable(String) │  Timestamp  │  String │ Nullable(String) │
├───────────────────┼────────────┼──────────────────┼──────────────────┼──────────────────┼─────────────────┼───────────────────────┼───────────────────┼──────────────────────┼──────────────────┼─────────────┼─────────┼──────────────────┤
│ my_internal_stage │ Internal   │ NULL             │ NULL             │ NULL             │ false           │ false                 │ NULL              │ {"compression":"Zst… │ 'root'@'%'       │ 2026-06-16  │         │ account_admin    │
│                   │            │                  │                  │                  │                 │                       │                   │                      │                  │ 22:21:19…   │         │                  │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

步骤 2. 上传示例文件

使用 LakeSQL 上传示例文件：

root@localhost:8000/default> CREATE STAGE my_internal_stage;

root@localhost:8000/default> PUT fs:///Users/eric/Documents/books.parquet @my_internal_stage

┌───────────────────────────────────────────────┐
│                 file                │  status │
│                String               │  String │
├─────────────────────────────────────┼─────────┤
│ /Users/eric/Documents/books.parquet │ SUCCESS │
└───────────────────────────────────────────────┘

验证 stage 中的文件：

LIST @my_internal_stage;

name                               |size  |md5                               |last_modified                |creator|
-----------------------------------+------+----------------------------------+-----------------------------+-------+
books.parquet                      |   998|"88432bf90aadb79073682988b39d461c"|2023-06-28 02:32:15.000 +0000|       |

步骤 3. 将数据复制到表中

使用 COPY INTO 命令将数据加载到目标表中：

COPY INTO books
FROM @my_internal_stage
FILES = ('books.parquet')
FILE_FORMAT = (
    TYPE = 'PARQUET'
);

验证已加载的数据：

SELECT * FROM books;

---
title                       |author             |date|
----------------------------+-------------------+----+
Transaction Processing      |Jim Gray           |1992|
Readings in Database Systems|Michael Stonebraker|2004|

教程 3：从外部 stage 加载

按照本教程将示例文件上传到外部 stage，并将 stage 中文件的数据加载到 TiDB Cloud Lake 中。

步骤 1. 创建外部 stage

使用 CREATE STAGE 命令创建外部 stage：

CREATE STAGE my_external_stage
    URL = 's3://lake'
    CONNECTION = (
        ENDPOINT_URL = 'http://127.0.0.1:9000',
        ACCESS_KEY_ID = 'ROOTUSER',
        SECRET_ACCESS_KEY = 'CHANGEME123'
    );

验证已创建的 stage：

SHOW STAGES;

name             |stage_type|creator           |comment|
-----------------+----------+------------------+-------+
my_external_stage|External  |'root'@'%'|       |

第 2 步：上传示例文件

使用 LakeSQL 上传示例文件：

root@localhost:8000/default> PUT fs:///Users/eric/Documents/books.parquet @my_external_stage

┌───────────────────────────────────────────────┐
│                 file                │  status │
│                String               │  String │
├─────────────────────────────────────┼─────────┤
│ /Users/eric/Documents/books.parquet │ SUCCESS │
└───────────────────────────────────────────────┘

验证已暂存的文件：

LIST @my_external_stage;

name         |size|md5                               |last_modified                |creator|
-------------+----+----------------------------------+-----------------------------+-------+
books.parquet| 998|"88432bf90aadb79073682988b39d461c"|2023-06-28 04:13:15.178 +0000|       |

第 3 步：将数据复制到表中

使用 COPY INTO 命令将数据加载到目标表中：

COPY INTO books
FROM @my_external_stage
FILES = ('books.parquet')
FILE_FORMAT = (
    TYPE = 'PARQUET'
);

验证已加载的数据：

SELECT * FROM books;

---
title                       |author             |date|
----------------------------+-------------------+----+
Transaction Processing      |Jim Gray           |1992|
Readings in Database Systems|Michael Stonebraker|2004|

从 Stage 加载

开始之前

教程 1：从用户 stage 加载

步骤 1. 上传示例文件

步骤 2. 将数据复制到表中

教程 2：从内部 stage 加载

步骤 1. 创建内部 stage

步骤 2. 上传示例文件

步骤 3. 将数据复制到表中

教程 3：从外部 stage 加载

步骤 1. 创建外部 stage

第 2 步：上传示例文件

第 3 步：将数据复制到表中

文档内容是否有帮助？