Синтаксис
Аргументы
Описание аргументов соответствует описанию аргументов табличных функцийs3, azureBlobStorage, HDFS и file.
format обозначает формат файлов данных в таблице Paimon.
Для paimonS3 можно использовать необязательный параметр extra_credentials, чтобы передать role_arn для доступа на основе ролей в ClickHouse Cloud. Шаги по настройке см. в разделе Secure S3.
Возвращаемое значение
Таблица с указанной структурой для чтения данных из указанной таблицы Paimon.Ограничения
Слияние при чтении (merge-on-read) не реализовано, поэтому чтение таблиц с первичным ключом не поддерживается: считыватель возвращает необработанное объединение файлов данных снимка, в котором остаются версии строк, уже замещённые последующими операциями upsert. По этой причине при чтении таблицы, в схеме которой объявленprimary-key, генерируется исключение.
Определение именованной коллекции
Ниже приведён пример настройки именованной коллекции для хранения URL и учётных данных:Псевдонимы
Табличная функцияpaimon теперь — псевдоним paimonS3.
Виртуальные столбцы
_path— Путь к файлу. Тип:LowCardinality(String)._file— Имя файла. Тип:LowCardinality(String)._size— Размер файла в байтах. Тип:Nullable(UInt64). Если размер файла неизвестен, значение —NULL._time— Время последнего изменения файла. Тип:Nullable(DateTime). Если время неизвестно, значение —NULL._etag— ETag файла. Тип:LowCardinality(String). Если ETag неизвестен, значение —NULL.
Поддерживаемые типы данных
Поддерживаемые ключи партиционирования
Типы данных, поддерживаемые в ключах партиционирования Paimon:CHARVARCHARBOOLEANDECIMALTINYINTSMALLINTINTEGERDATETIMETIMESTAMPTIMESTAMP WITH LOCAL TIME ZONEBIGINTFLOATDOUBLE