Справочник по функциям, предоставляемым расширением службы хранилища Azure в Базе данных Azure для PostgreSQL

Ниже приведен список функций, предоставляемых расширением службы хранилища Azure.

azure_storage.account_add

Функция, позволяющая добавлять учетную запись хранения и связанный ключ доступа в список учетных записей хранения, к которым azure_storage может получить доступ расширение.

Если предыдущее вызов этой функции уже добавило ссылку на эту учетную запись хранения, она не добавляет новую запись, а вместо этого обновляет ключ доступа существующей записи.

Замечание

Эта функция не проверяет, существует ли имя учетной записи или доступно ли оно с помощью ключа доступа. Однако он проверяет, является ли имя учетной записи хранения допустимым в соответствии с правилами проверки именования, введенными для учетных записей хранения Azure.

azure_storage.account_add(account_name_p text, account_key_p text);

Существует перегруженная версия этой функции, которая принимает account_config параметр, который инкапсулирует имя указанной учетной записи хранения Azure, а также все необходимые параметры, такие как тип проверки подлинности, тип учетной записи или учетные данные хранения.

azure_storage.account_add(account_config jsonb);

Разрешения

Должен быть членом azure_storage_admin.

Аргументы

account_name_p

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

account_key_p

text значение одного из ключей доступа для учетной записи хранения. Ключи доступа к хранилищу BLOB-объектов Azure похожи на корневой пароль для учетной записи хранения. Не забудьте защитить ключи доступа. Для безопасного управления и ротации ключей воспользуйтесь Azure Key Vault. Ключ учетной записи хранится в таблице, доступной только суперпользователем. Пользователи, которым предоставлена azure_storage_admin роль, могут взаимодействовать с этой таблицей с помощью функций. Чтобы узнать, какие учетные записи хранения добавляются, используйте функцию azure_storage.account_list.

account_config

jsonb имя учетной записи хранения Azure и все необходимые параметры, такие как тип проверки подлинности, тип учетной записи или учетные данные хранения. Мы рекомендуем использовать служебные функции azure_storage.account_options_managed_identity, azure_storage.account_options_credentials или azure_storage.account_options для создания любого из допустимых значений, которые необходимо передать в качестве этого аргумента.

Тип возвращаемого значения

VOID

azure_storage.account_options_managed_identity

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр в azure_storage.account_add и полезна для создания допустимого значения аргумента account_config при использовании управляемого удостоверения, назначенного системой, для взаимодействия с учетной записью хранения Azure.

azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

имя

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

тип

azure_storage.storage_type значение одного из поддерживаемых типов хранилища. Поддерживается blobтолько значение.

Тип возвращаемого значения

jsonb

azure_storage.account_options_credentials

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр в azure_storage.account_add и полезна для создания допустимого значения аргумента при использовании ключа доступа к службе хранилища Azure для account_config взаимодействия с учетной записью хранения Azure.

azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

имя

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

верительные грамоты

text значение одного из ключей доступа для учетной записи хранения. Ключи доступа к хранилищу BLOB-объектов Azure похожи на корневой пароль для учетной записи хранения. Не забудьте защитить ключи доступа. Для безопасного управления и ротации ключей воспользуйтесь Azure Key Vault. Ключ учетной записи хранится в таблице, доступной только суперпользователем. Пользователи, которым предоставлена azure_storage_admin роль, могут взаимодействовать с этой таблицей с помощью функций. Чтобы узнать, какие учетные записи хранения добавляются, используйте функцию azure_storage.account_list.

тип

azure_storage.storage_type значение одного из поддерживаемых типов хранилища. Поддерживается blobтолько значение.

Тип возвращаемого значения

jsonb

azure_storage.account_options

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр в azure_storage.account_add, и полезна для создания допустимого значения для account_config аргумента при использовании ключа доступа к службе хранилища Azure или управляемого удостоверения, назначенного системой, для взаимодействия с учетной записью хранения Azure.

azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

имя

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

auth_type

azure_storage.auth_type значение одного из поддерживаемых типов хранилища. Поддерживаются access-keyтолько значения, а managed-identityтакже .

storage_type

azure_storage.storage_type значение одного из поддерживаемых типов хранилища. Поддерживается blobтолько значение.

верительные грамоты

text значение одного из ключей доступа для учетной записи хранения. Ключи доступа к хранилищу BLOB-объектов Azure похожи на корневой пароль для учетной записи хранения. Не забудьте защитить ключи доступа. Для безопасного управления и ротации ключей воспользуйтесь Azure Key Vault. Ключ учетной записи хранится в таблице, доступной только суперпользователем. Пользователи, которым предоставлена azure_storage_admin роль, могут взаимодействовать с этой таблицей с помощью функций. Чтобы узнать, какие учетные записи хранения добавляются, используйте функцию azure_storage.account_list.

Тип возвращаемого значения

jsonb

azure_storage.account_remove

Функция, которая позволяет удалить учетную запись хранения и связанный с ним ключ доступа из списка учетных записей хранения, к которым azure_storage может получить доступ расширение.

azure_storage.account_remove(account_name_p text);

Разрешения

Должен быть членом azure_storage_admin.

Аргументы

account_name_p

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

Тип возвращаемого значения

VOID

azure_storage.account_user_add

Функция, которая позволяет предоставлять пользователю Или роли PostgreSQL доступ к учетной записи хранения через функции, предоставляемые расширением azure_storage .

Замечание

Выполнение этой функции выполняется только в том случае, если учетная запись хранения, имя которой передается в качестве первого аргумента, уже была создана с помощью azure_storage.account_add, и если пользователь или роль, имя которой передается в качестве второго аргумента, уже существует.

azure_storage.account_add(account_name_p text, user_p regrole);

Разрешения

Должен быть членом azure_storage_admin.

Аргументы

account_name_p

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

user_p

regrole имя пользователя Или роли PostgreSQL, доступной на сервере.

Тип возвращаемого значения

VOID

azure_storage.account_user_remove

Функция, которая позволяет отменить доступ пользователя Или роли PostgreSQL к учетной записи хранения через функции, предоставляемые расширением azure_storage .

Замечание

Выполнение этой функции выполняется только в том случае, если имя учетной записи хранения, имя которой передается в качестве первого аргумента, уже создано с помощью azure_storage.account_add, и если пользователь или роль, имя которой передается в качестве второго аргумента, по-прежнему существует. При удалении пользователя или роли с сервера путем выполнения DROP USER | ROLEразрешения, предоставленные в любой ссылке на учетные записи хранения Azure, также удаляются автоматически.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Разрешения

Должен быть членом azure_storage_admin.

Аргументы

account_name_p

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

user_p

regrole имя пользователя Или роли PostgreSQL, доступной на сервере.

Тип возвращаемого значения

VOID

azure_storage.account_list

Функция, которая перечисляет имена учетных записей хранения, настроенных с помощью функции azure_storage.account_add , вместе с пользователями или ролями PostgreSQL, которые предоставляют разрешения на взаимодействие с этой учетной записью хранения через функции, предоставляемые azure_storage расширением.

azure_storage.account_list();

Разрешения

Должен быть членом azure_storage_admin.

Аргументы

Эта функция не принимает никаких аргументов.

Тип возвращаемого значения

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) таблица с четырьмя столбцами со списком добавленных учетных записей хранения Azure, типом проверки подлинности, используемой для взаимодействия с каждой учетной записью, типом хранилища и списком пользователей или ролей PostgreSQL, которым предоставлен доступ.

azure_storage.blob_list

Функция, которая перечисляет имена и другие свойства (размер, lastModified, eTag, contentType, contentEncoding и contentHash) больших двоичных объектов, хранящихся в указанном контейнере указанной учетной записи хранения.

azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);

Разрешения

Пользователь или роль, вызывающие эту функцию, необходимо добавить в список разрешенных пользователей, account_name выполнив azure_storage.account_user_add. azure_storage_admin Участники автоматически могут ссылаться на все учетные записи хранения Azure, ссылки на которые были добавлены с помощью azure_storage.account_add.

Аргументы

account_name

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

имя_контейнера

text имя контейнера. Контейнер организует набор блобов, аналогично каталогу в файловой системе. Учетная запись хранения может включать неограниченное количество контейнеров, а контейнер может содержать неограниченное количество блобов. Имя контейнера должно быть допустимым именем системы доменных имен (DNS), так как оно входит в уникальный универсальный код ресурса (URI), используемый для адресов контейнера или больших двоичных объектов. При именовании контейнера обязательно следуйте этим правилам.

Универсальный код ресурса (URI) для контейнера аналогичен: https://myaccount.blob.core.windows.net/mycontainer

префикс

text При указании функция возвращает большие двоичные объекты, имена которых начинаются со значения, указанного в этом параметре. По умолчанию используется пустая строка.

Тип возвращаемого значения

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) Таблица с одной записью для каждого возвращаемого большого двоичного объекта, включая полное имя большого двоичного объекта и некоторые другие свойства.

путь

text полное имя большого двоичного объекта.

байт

bigint размер большого двоичного объекта в байтах.

last_modified

timestamp with time zoneдата и время последнего изменения большого двоичного объекта. Любая операция, которая изменяет большой двоичный объект, включая обновление метаданных или свойств большого двоичного объекта, изменяет время последнего изменения большого двоичного объекта.

ETag

text Свойство ETag используется для оптимистического параллелизма во время обновлений. Это не метка времени, так как есть другое свойство с именем Timestamp, которое сохраняет последний раз, когда запись была обновлена. Например, если вы загружаете сущность и хотите обновить ее, ETag должна соответствовать тому, что сейчас хранится. Настройка соответствующего ETag важна, так как если у вас несколько пользователей редактировали один и тот же элемент, вы не хотите, чтобы они перезаписывали изменения друг друга.

content_type

text Тип контента, указанный для большого двоичного объекта. Тип контента по умолчанию — application/octet-stream.

content_encoding

text Свойство Content-Encoding большого двоичного объекта, который позволяет определить хранилище Azure. Для сжатого содержимого можно задать для свойства Gzip. Когда браузер обращается к содержимому, он автоматически распаковывает содержимое.

content_hash

text Хэш, используемый для проверки целостности большого двоичного объекта во время транспорта. При указании этого заголовка служба хранилища проверяет предоставленный хэш с одним вычисляемого из содержимого. Если два хэша не соответствуют, операция завершается ошибкой с кодом 400 (недопустимый запрос).

azure_storage.blob_get

Функция, которая позволяет импортировать данные. Он скачивает файл из контейнера BLOB-объектов в учетной записи хранения Azure. Затем он преобразует содержимое в строки, которые можно использовать и обрабатывать с помощью конструкций языка SQL. Эта функция добавляет поддержку фильтрации и управления данными, полученными из контейнера BLOB-объектов перед импортом.

Замечание

Прежде чем пытаться получить доступ к контейнеру для указанной учетной записи хранения, эта функция проверяет, допустимы ли имена учетной записи хранения и контейнера в качестве аргументов в соответствии с правилами проверки именования, введенными в учетных записях хранения Azure. Если один из них недопустим, возникает ошибка.

azure_storage.blob_get(account_name text, container_name text, path text, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);

Существует перегруженная версия этой функции, которая принимает rec параметр, позволяющий удобно определять запись выходного формата.

azure_storage.blob_get(account_name text, container_name text, path text, rec anyelement, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);

Разрешения

Пользователь или роль, вызывающие эту функцию, необходимо добавить в список разрешенных пользователей, account_name выполнив azure_storage.account_user_add. azure_storage_admin Участники автоматически могут ссылаться на все учетные записи хранения Azure, ссылки на которые были добавлены с помощью azure_storage.account_add.

Аргументы

account_name

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

имя_контейнера

text имя контейнера. Контейнер организует набор блобов, аналогично каталогу в файловой системе. Учетная запись хранения может включать неограниченное количество контейнеров, а контейнер может содержать неограниченное количество блобов. Имя контейнера должно быть допустимым именем системы доменных имен (DNS), так как оно входит в уникальный универсальный код ресурса (URI), используемый для адресов контейнера или больших двоичных объектов. При именовании контейнера обязательно следуйте этим правилам.

Универсальный код ресурса (URI) для контейнера аналогичен: https://myaccount.blob.core.windows.net/mycontainer

путь

text полное имя большого двоичного объекта.

rec

anyelement определение выходной структуры записи.

дешифратор

text спецификация формата большого двоичного объекта. Можно задать любое из следующих значений:

Формат	По умолчанию	Описание
auto	true	Выводит значение на основе последней серии символов, назначенных имени большого двоичного объекта. Если имя большого двоичного объекта заканчивается .parquet, предполагается parquet. Если заканчивается или .csv.csv.gzпредполагается csv. Если заканчивается или .tsv.tsv.gzпредполагается tsv. Если заканчивается , .json.json.gz.xml.xml.gz.txtили .txt.gz, предполагается.text
binary		Двоичный формат PostgreSQL COPY.
csv		Формат разделенных запятыми значений, используемый PostgreSQL COPY.
parquet		Формат Parquet.
text | xml | json		Файл, содержащий одно текстовое значение.
tsv		Значения, разделенные табуляции, формат копирования PostgreSQL по умолчанию.

сжатие

text спецификация типа сжатия. Можно задать любое из следующих значений:

Формат	По умолчанию	Описание
auto	true	Выводит значение на основе последней серии символов, назначенных имени большого двоичного объекта. Если имя большого двоичного объекта заканчивается .gz, предполагается gzip. В противном случае предполагается none.
brotli		Принудительно использует алгоритм сжатия brotli для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .
gzip		Принудительно использует алгоритм сжатия gzip для сжатия большого двоичного объекта.
lz4		Принудительно использует алгоритм сжатия lz4 для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .
none		Принудительное сжатие большого двоичного объекта.
snappy		Принудительное сжатие с помощью алгоритма сжатия snappy для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .
zstd		Принудительно использует алгоритм сжатия zstd для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .

Расширение не поддерживает другие типы сжатия.

опции

jsonb Параметры, определяющие обработку пользовательских заголовков, настраиваемых разделителей, escape-символов и т. д. options влияет на поведение этой функции таким образом, как параметры, которые можно передать команде COPY в PostgreSQL, влияют на его поведение.

Тип возвращаемого значения

SETOF record SETOF anyelement

azure_storage.blob_put

Функция, которая позволяет экспортировать данные, отправляя файлы в контейнер BLOB-объектов в учетной записи хранения Azure. Содержимое файлов создается из строк в PostgreSQL.

Замечание

Прежде чем пытаться получить доступ к контейнеру для указанной учетной записи хранения, эта функция проверяет, допустимы ли имена учетной записи хранения и контейнера в качестве аргументов в соответствии с правилами проверки именования, введенными в учетных записях хранения Azure. Если один из них недопустим, возникает ошибка.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;

Существует перегруженная версия функции, содержащая encoder параметр, который позволяет указать кодировщик, который следует использовать, если его нельзя вывести из расширения path параметра, или когда требуется переопределить один вывод.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;

Существует перегруженная версия функции, которая также содержит compression параметр, который позволяет указать сжатие, используемое, когда его нельзя выводить из расширения path параметра, или когда требуется переопределить вывод одного из выводимых.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;

Существует перегруженная версия функции, которая также содержит options параметр для обработки пользовательских заголовков, пользовательских разделителей, escape-символов и т. д. options работает аналогично параметрам, которые можно передать команде COPY в PostgreSQL.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;

Разрешения

Пользователь или роль, вызывающие эту функцию, необходимо добавить в список разрешенных пользователей, account_name выполнив azure_storage.account_user_add. azure_storage_admin Участники автоматически могут ссылаться на все учетные записи хранения Azure, ссылки на которые были добавлены с помощью azure_storage.account_add.

Аргументы

account_name

text Имя учетной записи хранения BLOB-объектов Azure, содержащей все объекты: большие двоичные объекты, файлы, очереди и таблицы. Учетная запись хранения предоставляет уникальное пространство имен, доступное из любой точки мира по протоколу HTTPS.

имя_контейнера

text имя контейнера. Контейнер организует набор блобов, аналогично каталогу в файловой системе. Учетная запись хранения может включать неограниченное количество контейнеров, а контейнер может содержать неограниченное количество блобов. Имя контейнера должно быть допустимым именем системы доменных имен (DNS), так как оно входит в уникальный универсальный код ресурса (URI), используемый для адресов контейнера или больших двоичных объектов. При именовании контейнера обязательно следуйте этим правилам.

Универсальный код ресурса (URI) для контейнера аналогичен: https://myaccount.blob.core.windows.net/mycontainer

путь

text полное имя большого двоичного объекта.

кортеж

record определение выходной структуры записи.

кодировщик

text спецификация формата большого двоичного объекта. Можно задать любое из следующих значений:

Формат	По умолчанию	Описание
auto	true	Выводит значение на основе последней серии символов, назначенных имени большого двоичного объекта. Если имя большого двоичного объекта заканчивается .csv или .csv.gzпредполагается csv. Если заканчивается или .tsv.tsv.gzпредполагается tsv. Если заканчивается , .json.json.gz.xml.xml.gz.txtили .txt.gz, предполагается.text
binary		Двоичный формат PostgreSQL COPY.
csv		Формат разделенных запятыми значений, используемый PostgreSQL COPY.
parquet		Формат Parquet.
text | xml | json		Файл, содержащий одно текстовое значение.
tsv		Значения, разделенные табуляции, формат копирования PostgreSQL по умолчанию.

сжатие

text спецификация типа сжатия. Можно задать любое из следующих значений:

Формат	По умолчанию	Описание
auto	true	Выводит значение на основе последней серии символов, назначенных имени большого двоичного объекта. Если имя большого двоичного объекта заканчивается .gz, предполагается gzip. В противном случае предполагается none.
brotli		Принудительно использует алгоритм сжатия brotli для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .
gzip		Принудительно использует алгоритм сжатия gzip для сжатия большого двоичного объекта.
lz4		Принудительно использует алгоритм сжатия lz4 для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .
none		Принудительное сжатие большого двоичного объекта.
snappy		Принудительное сжатие с помощью алгоритма сжатия snappy для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .
zstd		Принудительно использует алгоритм сжатия zstd для сжатия большого двоичного объекта. Поддерживается только кодировщиком parquet .

Расширение не поддерживает другие типы сжатия.

опции

jsonb Параметры, определяющие обработку пользовательских заголовков, настраиваемых разделителей, escape-символов и т. д. options влияет на поведение этой функции таким образом, как параметры, которые можно передать команде COPY в PostgreSQL, влияют на его поведение.

Тип возвращаемого значения

VOID

azure_storage.options_copy

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр внутри blob_get. Он выступает в качестве вспомогательной функции для options_parquet, options_csv_get, options_tsv и options_binary.

azure_storage.options_copy(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_quote text[] DEFAULT NULL::text[], force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

разделитель

text Символ, разделяющий столбцы в каждой строке (строке) файла. Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY delimiter must be a single one-byte character .

null_string

text строка, представляющая значение NULL. Значение по умолчанию — \N (backslash-N) в текстовом формате и неквалированная пустая строка в формате CSV. Вы можете предпочесть пустую строку даже в текстовом формате, если вы не хотите различать значения NULL от пустых строк.

авторизации

boolean флаг, указывающий, содержит ли файл строку заголовка с именами каждого столбца в файле. В выходных данных начальная строка содержит имена столбцов из таблицы.

цитировать

text символ кавычек, используемый при кавычках значения данных. По умолчанию используется двойная кавычка. Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY quote must be a single one-byte character .

побег

text Символ, который должен отображаться перед символом данных, соответствующим значению QUOTE. Значение по умолчанию совпадает со значением QUOTE (чтобы символ кавычки был двойным, если он отображается в данных). Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY escape must be a single one-byte character .

force_quote

text[] принудительно используется для всех значений, отличных от NULL, в каждом указанном столбце. Выходные данные NULL никогда не цитируются. Если задано значение *, значения, отличные от NULL, указываются во всех столбцах.

force_not_null

text[] не совпадайте со значениями указанных столбцов со строкой NULL. В случае, если строка NULL пуста, это означает, что пустые значения считываются как строки нулевой длины, а не null, даже если они не кавычки.

force_null

text[] сопоставляет значения указанных столбцов со строкой NULL, даже если кавычки найдены, а если совпадение найдено, задайте значение NULL. В случае, если строка NULL пуста, она преобразует в кавычки пустую строку в NULL.

content_encoding

text имя кодировки, с которой кодируется файл. Если параметр опущен, используется текущая кодировка клиента.

Тип возвращаемого значения

jsonb

azure_storage.options_parquet

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр внутри blob_get, и полезна для декодирования содержимого файла parquet.

azure_storage.options_parquet();

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

Тип возвращаемого значения

jsonb

azure_storage.options_csv_get

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр внутри blob_get, и полезна для декодирования содержимого CSV-файла.

azure_storage.options_csv_get(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

разделитель

text Символ, разделяющий столбцы в каждой строке (строке) файла. Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY delimiter must be a single one-byte character .

null_string

text строка, представляющая значение NULL. Значение по умолчанию — \N (backslash-N) в текстовом формате и неквалированная пустая строка в формате CSV. Вы можете предпочесть пустую строку даже в текстовом формате, если вы не хотите различать значения NULL от пустых строк.

авторизации

boolean флаг, указывающий, содержит ли файл строку заголовка с именами каждого столбца в файле. В выходных данных начальная строка содержит имена столбцов из таблицы.

цитировать

text символ кавычек, используемый при кавычках значения данных. По умолчанию используется двойная кавычка. Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY quote must be a single one-byte character .

побег

text Символ, который должен отображаться перед символом данных, соответствующим значению QUOTE. Значение по умолчанию совпадает со значением QUOTE (чтобы символ кавычки был двойным, если он отображается в данных). Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY escape must be a single one-byte character .

force_not_null

text[] не совпадайте со значениями указанных столбцов со строкой NULL. В случае, если строка NULL пуста, это означает, что пустые значения считываются как строки нулевой длины, а не null, даже если они не кавычки.

force_null

text[] сопоставляет значения указанных столбцов со строкой NULL, даже если кавычки найдены, а если совпадение найдено, задайте значение NULL. В случае, если строка NULL пуста, она преобразует в кавычки пустую строку в NULL.

content_encoding

text имя кодировки, с которой кодируется файл. Если параметр опущен, используется текущая кодировка клиента.

Тип возвращаемого значения

jsonb

azure_storage.options_tsv

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр внутри blob_get, и полезна для декодирования содержимого tsv-файла.

azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

разделитель

text Символ, разделяющий столбцы в каждой строке (строке) файла. Это должен быть один 1-байтовый символ. Хотя эта функция поддерживает разделители любого количества символов, если вы пытаетесь использовать более одного байтового символа, PostgreSQL сообщает об ошибке COPY delimiter must be a single one-byte character .

null_string

text строка, представляющая значение NULL. Значение по умолчанию — \N (backslash-N) в текстовом формате и неквалированная пустая строка в формате CSV. Вы можете предпочесть пустую строку даже в текстовом формате, если вы не хотите различать значения NULL от пустых строк.

content_encoding

text имя кодировки, с которой кодируется файл. Если параметр опущен, используется текущая кодировка клиента.

Тип возвращаемого значения

jsonb

azure_storage.options_binary

Функция, которая выступает в качестве служебной функции, которая может вызываться как параметр внутри blob_get, и полезна для декодирования содержимого двоичного файла.

azure_storage.options_binary(content_encoding text DEFAULT NULL::text);

Разрешения

Любой пользователь или роль могут вызывать эту функцию.

Аргументы

content_encoding

text имя кодировки, с которой кодируется файл. Если параметр опущен, используется текущая кодировка клиента.

Тип возвращаемого значения

jsonb

Связанный контент

• Расширение службы хранилища Azure.
• Настройте расширение службы хранилища Azure.
• Примеры краткого руководства.
• Устранение ошибок.
• Расширения и модули.