Перейти к основному содержимому
Перейти к основному содержимому

azureBlobStorage Табличная Функция

Предоставляет интерфейс в виде таблицы для выбора/вставки файлов в Azure Blob Storage. Эта табличная функция похожа на функцию s3.

Синтаксис

Аргументы

  • connection_string|storage_account_url — connection_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 Storage. Подробности здесь. Ниже мы предполагаем, что Azurite доступен по имени хоста azurite1.

Запись данных в Azure Blob Storage с использованием следующего:

А затем его можно читать, используя

или используя 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) — это URI, который предоставляет ограниченный доступ к контейнеру или файлу Azure Storage. Используйте его, чтобы предоставить временно ограниченный доступ к ресурсам учетной записи хранения без передачи ключа учетной записи хранения. Подробности здесь.

Функция azureBlobStorage поддерживает Подписи Общего Доступа (SAS).

Token Blob SAS содержит всю информацию, необходимую для аутентификации запроса, включая целевой blob, разрешения и срок действия. Чтобы построить URL-адрес blob, добавьте токен SAS к конечной точке службы blob. Например, если конечная точка — https://clickhousedocstest.blob.core.windows.net/, запрос становится:

В качестве альтернативы пользователи могут использовать сгенерированный Blob SAS URL: