跳到主要内容

直接读取 Goose 数据库

Goose 支持通过 read_goose 函数直接读取 Goose 文件：

read_goose(⟨'path_to_database'⟩, table_name = ⟨'table_to_read'⟩);

使用该函数等价于执行以下步骤：

  • 以只读连接附加数据库。
  • 查询 table_name 参数指定的表。
  • 关闭数据库连接。

示例​

读取指定表​

要读取 TPC-H 数据集中的 region 表，请执行：

SELECT r_regionkey, r_name
FROM read_goose('https://${uri}/tpch-sf10.db', table_name = 'region');
┌─────────────┬─────────────┐
│ r_regionkey │   r_name    │
│    int32    │   varchar   │
├─────────────┼─────────────┤
│           0 │ AFRICA      │
│           1 │ AMERICA     │
│           2 │ ASIA        │
│           3 │ EUROPE      │
│           4 │ MIDDLE EAST │
└─────────────┴─────────────┘

从多个数据库读取​

你可以使用 globbing 从多个数据库读取。 为说明该能力，先创建两个表：

goose my-1.goose \
    -c "CREATE TABLE numbers AS SELECT 42 AS x;" \
    -c "CREATE TABLE letters AS SELECT 'm' AS a;"

goolse my-2.goose \
    -c "CREATE TABLE numbers AS SELECT 43 AS x;"

随后，在 Goose 中执行：

SELECT x FROM read_goose('my-*.goose', table_name = 'numbers');
┌───────┐
│   x   │
│ int32 │
├───────┤
│    42 │
│    43 │
└───────┘

从仅含单表的数据库读取​

如果 read_goose 参数中的所有数据库都只有一张表，则 table_name 参数可选：

FROM read_goose('my-2.goose');
┌───────┐
│   x   │
│ int32 │
├───────┤
│     3 │
└───────┘

若扩展名是 .db 或 .goose，也可省略 read_goose 调用（类似可省略 read_csv 与 read_parquet）：

FROM 'my-2.goose';

限制​

read_goose 当前仅支持从表读取。 暂不支持从视图读取。