跳到主要内容
跳到主要内容

azureBlobStorage 表函数

提供类似表的接口，用于在 Azure Blob Storage 中选择/插入文件。这个表函数类似于 s3 函数。

语法​

参数​

参数描述
connection_string| storage_account_urlconnection_string 包含账户名称和密钥 (创建连接字符串)，或者您也可以在这里提供存储账户 URL，并将账户名称和账户密钥作为单独的参数提供（见参数 account_name 和 account_key）
container_name容器名称
blobpath文件路径。在只读模式下支持以下通配符：*、**、?、{abc,def} 和 {N..M}，其中 N、M 为数字，'abc'、'def' 为字符串。
account_name如果使用了 storage_account_url，则可以在此指定账户名称
account_key如果使用了 storage_account_url，则可以在此指定账户密钥
format文件的 格式。
compression支持的值：none、gzip/gz、brotli/br、xz/LZMA、zstd/zst。默认情况下，通过文件扩展名自动检测压缩（与设置为 auto 相同）。
structure表的结构。格式为 'column1_name column1_type, column2_name column2_type, ...'。

返回值​

一个具有指定结构的表，用于读取或写入指定文件中的数据。

示例​

类似于 AzureBlobStorage 表引擎，用户可以使用 Azurite 模拟器进行本地 Azure 存储开发。更多详细信息 在这里。下面我们假设 Azurite 在主机名 azurite1 可用。

使用以下内容将数据写入 Azure Blob 存储：

然后可以使用

或使用 connection_string

虚拟列​

  • _path — 文件的路径。类型：LowCardinality(String)。
  • _file — 文件名。类型：LowCardinality(String)。
  • _size — 文件大小（字节）。类型：Nullable(UInt64)。如果文件大小未知，则值为 NULL。
  • _time — 文件的最后修改时间。类型：Nullable(DateTime)。如果时间未知，则值为 NULL。

Hive 风格分区​

当设置 use_hive_partitioning 为 1 时，ClickHouse 将检测路径中的 Hive 风格分区（/name=value/），并允许在查询中使用分区列作为虚拟列。这些虚拟列将与分区路径中的名称相同，但以 _ 开头。

示例

使用 Hive 风格分区创建的虚拟列

使用共享访问签名 (SAS)​

共享访问签名 (SAS) 是授予对 Azure 存储容器或文件的受限访问的 URI。使用它可以在不分享存储账户密钥的情况下提供对存储账户资源的限时访问。更多详细信息 在这里。

azureBlobStorage 函数支持共享访问签名 (SAS)。

Blob SAS 令牌包含了所有需要验证请求的信息，包括目标 Blob、权限和有效期。要构建一个 blob URL，请将 SAS 令牌附加到 Blob 服务端点。例如，如果端点是 https://clickhousedocstest.blob.core.windows.net/，请求变为：

或者，用户可以使用生成的 Blob SAS URL：