Referência de funções fornecidas pela extensão de Armazenamento do Azure no Banco de Dados do Azure para PostgreSQL

Veja a seguir a lista de funções fornecidas pela extensão de Armazenamento do Azure:

azure_storage.account_add

Função que permite adicionar uma conta de armazenamento e sua chave de acesso associada à lista de contas de armazenamento que a azure_storage extensão pode acessar.

Se uma invocação anterior dessa função já tiver adicionado a referência a essa conta de armazenamento, ela não adicionará uma nova entrada, mas atualizará a chave de acesso da entrada existente.

Observação

Essa função não valida se o nome da conta referenciada existe ou se está acessível com a chave de acesso fornecida. No entanto, ele valida que o nome da conta de armazenamento é válido, de acordo com as regras de validação de nomenclatura impostas às contas de armazenamento do Azure.

azure_storage.account_add(account_name_p text, account_key_p text);

Há uma versão sobrecarregada dessa função, que aceita um account_config parâmetro que encapsula o nome da conta de Armazenamento do Azure referenciada e todas as configurações necessárias, como tipo de autenticação, tipo de conta ou credenciais de armazenamento.

azure_storage.account_add(account_config jsonb);

Permissões

Deve ser um membro de azure_storage_admin.

Argumentos

account_name_p

text o nome da conta de armazenamento de blobs do Azure que contém todos os seus objetos: blobs, arquivos, filas e tabelas. A conta de armazenamento fornece um namespace exclusivo acessível de qualquer lugar do mundo por HTTPS.

account_key_p

text o valor de uma das chaves de acesso da conta de armazenamento. As chaves de acesso do armazenamento de blobs do Azure são semelhantes a uma senha raiz para sua conta de armazenamento. Sempre tenha cuidado para proteger as suas chaves de acesso. Utilize o Azure Key Vault para gerenciar e girar suas chaves com segurança. A chave da conta é armazenada em uma tabela acessível somente pelo superusuário. Os usuários que receberam a azure_storage_admin função podem interagir com essa tabela por meio de funções. Para ver quais contas de armazenamento são adicionadas, use a função azure_storage.account_list.

account_config

jsonb o nome da conta de Armazenamento do Azure e todas as configurações necessárias, como tipo de autenticação, tipo de conta ou credenciais de armazenamento. Recomendamos o uso das funções de utilitário azure_storage.account_options_managed_identity, azure_storage.account_options_credentials ou azure_storage.account_options para criar qualquer um dos valores válidos que devem ser passados como esse argumento.

Tipo de retorno

VOID

azure_storage.account_options_managed_identity

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro em azure_storage.account_add, e é útil para produzir um valor válido para o account_config argumento, ao usar uma identidade gerenciada atribuída pelo sistema para interagir com a conta de Armazenamento do Azure.

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

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

nome

tipo

azure_storage.storage_type o valor de um dos tipos de armazenamento com suporte. Somente o valor com suporte é blob.

Tipo de retorno

jsonb

azure_storage.account_options_credentials

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro em azure_storage.account_add e é útil para produzir um valor válido para o account_config argumento, ao usar uma chave de acesso do Armazenamento do Azure para interagir com a conta de Armazenamento do Azure.

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

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

nome

credenciais

tipo

azure_storage.storage_type o valor de um dos tipos de armazenamento com suporte. Somente o valor com suporte é blob.

Tipo de retorno

jsonb

azure_storage.account_options

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro em azure_storage.account_add, e é útil para produzir um valor válido para o account_config argumento, ao usar uma chave de acesso do Armazenamento do Azure ou uma identidade gerenciada atribuída pelo sistema para interagir com a conta de Armazenamento do Azure.

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

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

nome

auth_type

azure_storage.auth_type o valor de um dos tipos de armazenamento com suporte. Somente valores com suporte são access-key, e managed-identity.

storage_type

azure_storage.storage_type o valor de um dos tipos de armazenamento com suporte. Somente o valor com suporte é blob.

credenciais

Tipo de retorno

jsonb

azure_storage.account_remove

Função que permite remover uma conta de armazenamento e sua chave de acesso associada da lista de contas de armazenamento que a azure_storage extensão pode acessar.

azure_storage.account_remove(account_name_p text);

Permissões

Deve ser um membro de azure_storage_admin.

Argumentos

account_name_p

Tipo de retorno

VOID

azure_storage.account_user_add

Função que permite conceder a um usuário do PostgreSQL ou à função acesso a uma conta de armazenamento por meio das funções fornecidas pela azure_storage extensão.

Observação

A execução dessa função só terá êxito se a conta de armazenamento, cujo nome está sendo passado como o primeiro argumento, já tiver sido criada usando azure_storage.account_add e se o usuário ou a função, cujo nome é passado como o segundo argumento, já existir.

azure_storage.account_add(account_name_p text, user_p regrole);

Permissões

Deve ser um membro de azure_storage_admin.

Argumentos

account_name_p

user_p

regrole o nome de um usuário ou função postgreSQL disponível no servidor.

Tipo de retorno

VOID

azure_storage.account_user_remove

Função que permite revogar um usuário do PostgreSQL ou acesso de função a uma conta de armazenamento por meio das funções fornecidas pela azure_storage extensão.

Observação

A execução dessa função só terá êxito se a conta de armazenamento cujo nome está sendo passado como o primeiro argumento já tiver sido criada usando azure_storage.account_add e se o usuário ou a função cujo nome for passado como o segundo argumento ainda existir. Quando um usuário ou função é removido do servidor, executando DROP USER | ROLE, as permissões concedidas em qualquer referência às contas do Armazenamento do Azure também são eliminadas automaticamente.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Permissões

Deve ser um membro de azure_storage_admin.

Argumentos

account_name_p

user_p

regrole o nome de um usuário ou função postgreSQL disponível no servidor.

Tipo de retorno

VOID

azure_storage.account_list

Função que lista os nomes das contas de armazenamento que foram configuradas por meio da função azure_storage.account_add , juntamente com os usuários ou funções do PostgreSQL que recebem permissões para interagir com essa conta de armazenamento por meio das funções fornecidas pela azure_storage extensão.

azure_storage.account_list();

Permissões

Deve ser um membro de azure_storage_admin.

Argumentos

Essa função não aceita argumentos.

Tipo de retorno

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) uma tabela de quatro colunas com a lista de contas de Armazenamento do Azure adicionadas, o tipo de autenticação usado para interagir com cada conta, o tipo de armazenamento e a lista de usuários ou funções do PostgreSQL que recebem acesso a ela.

azure_storage.blob_list

Função que lista os nomes e outras propriedades (tamanho, lastModified, eTag, contentType, contentEncoding e contentHash) de blobs armazenados no contêiner fornecido da conta de armazenamento referida.

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

Permissões

O usuário ou função que invoca essa função deve ser adicionado à lista de permissões para o account_name referenciado, executando azure_storage.account_user_add. Os membros têm azure_storage_admin permissão automaticamente para fazer referência a todas as contas de Armazenamento do Azure cujas referências foram adicionadas usando azure_storage.account_add.

Argumentos

account_name

nome_do_container

text o nome de um contêiner. Um contêiner organiza um conjunto de blobs, semelhante a um diretório em um sistema de arquivos. Uma conta de armazenamento pode incluir um número ilimitado de contêineres e um contêiner pode armazenar um número ilimitado de blobs. Um nome de contêiner deve ser um nome DNS (Sistema de Nomes de Domínio) válido, pois ele faz parte do URI exclusivo usado para endereçar o contêiner ou seus blobs. Ao nomear um contêiner, certifique-se de seguir essas regras.

O URI de um contêiner é semelhante a: https://myaccount.blob.core.windows.net/mycontainer

prefixo

text quando especificada, a função retorna os blobs cujos nomes começam com o valor fornecido neste parâmetro. O padrão é uma cadeia de caracteres vazia.

Tipo de retorno

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) uma tabela com um registro por blob retornado, incluindo o nome completo do blob e algumas outras propriedades.

caminho

text o nome completo do blob.

Bytes

bigint o tamanho do blob em bytes.

last_modified

timestamp with time zonea data e a hora em que o blob foi modificado pela última vez. Qualquer operação que modifique o blob, incluindo uma atualização dos metadados ou das propriedades do blob, altera a hora da última modificação do blob.

etag

text a propriedade ETag é usada para simultaneidade otimista durante as atualizações. Não é um carimbo de data/hora, pois há outra propriedade chamada Timestamp que armazena a última vez que um registro foi atualizado. Por exemplo, se você carregar uma entidade e quiser atualizá-la, a ETag deverá corresponder ao que está armazenado no momento. Definir a ETag apropriada é importante porque se você tiver vários usuários editando o mesmo item, não deseja que eles substituam as alterações uns dos outros.

content_type

text o tipo de conteúdo especificado para o blob. O tipo de conteúdo padrão é application/octet-stream.

content_encoding

text a propriedade Content-Encoding de um blob que o Armazenamento do Azure permite definir. Para conteúdo compactado, você pode definir a propriedade como Gzip. Quando o navegador acessa o conteúdo, ele descompacta automaticamente o conteúdo.

content_hash

text o hash usado para verificar a integridade do blob durante o transporte. Quando esse cabeçalho é especificado, o serviço de armazenamento verifica o hash fornecido com um computado do conteúdo. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Solicitação Incorreta).

azure_storage.blob_get

Função que permite a importação de dados. Ele baixa um arquivo de um contêiner de blob em uma conta de Armazenamento do Azure. Em seguida, ele converte o conteúdo em linhas, que podem ser consumidas e processadas com constructos de linguagem SQL. Essa função adiciona suporte para filtrar e manipular os dados buscados do contêiner de blob antes de importá-lo.

Observação

Antes de tentar acessar o contêiner da conta de armazenamento referida, essa função verifica se os nomes da conta de armazenamento e do contêiner passados como argumentos são válidos de acordo com as regras de validação de nomenclatura impostas às contas de armazenamento do Azure. Se um deles for inválido, um erro será gerado.

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);

Há uma versão sobrecarregada dessa função, que aceita um rec parâmetro que permite definir convenientemente o registro de formato de saída.

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);

Permissões

Argumentos

account_name

nome_do_container

O URI de um contêiner é semelhante a: https://myaccount.blob.core.windows.net/mycontainer

caminho

text o nome completo do blob.

Rec

anyelement a definição da estrutura de saída do registro.

decodificador

text a especificação do formato de blob. Pode ser definido como qualquer um dos seguintes valores:

Formato	Inadimplência	Descrição
`auto`	`true`	Infere o valor com base na última série de caracteres atribuídos ao nome do blob. Se o nome do blob terminar, `.parquet`ele pressupõe `parquet`. Se terminar com `.csv` ou `.csv.gz`, ele pressupõe `csv`. Se terminar com `.tsv` ou `.tsv.gz`, ele pressupõe `tsv`. Se terminar com `.json`, `.json.gz`, , `.xml`, `.xml.gz.txt`ou `.txt.gz`, ele pressupõe `text`.
`binary`		Formato copy do PostgreSQL binário.
`csv`		Formato de valores separados por vírgulas usado pelo PostgreSQL COPY.
`parquet`		Formato Parquet.
`text` \| `xml` \| `json`		Um arquivo que contém um único valor de texto.
`tsv`		Valores separados por tabulação, o formato padrão postgreSQL COPY.

compactação

text a especificação do tipo de compactação. Pode ser definido como qualquer um dos seguintes valores:

Formato	Inadimplência	Descrição
`auto`	`true`	Infere o valor com base na última série de caracteres atribuídos ao nome do blob. Se o nome do blob terminar, `.gz`ele pressupõe `gzip`. Caso contrário, ele pressupõe `none`.
`brotli`		Força o uso do algoritmo de compactação brotli para compactar o blob. Compatível apenas com `parquet` o codificador.
`gzip`		Força o uso do algoritmo de compactação gzip para compactar o blob.
`lz4`		Força o uso do algoritmo de compactação lz4 para compactar o blob. Compatível apenas com `parquet` o codificador.
`none`		Força a não compactar o blob.
`snappy`		Força o uso de algoritmo de compactação rápida para compactar o blob. Compatível apenas com `parquet` o codificador.
`zstd`		Força o uso do algoritmo de compactação zstd para compactar o blob. Compatível apenas com `parquet` o codificador.

A extensão não dá suporte a nenhum outro tipo de compactação.

Opções

jsonb as configurações que definem o tratamento de cabeçalhos personalizados, separadores personalizados, caracteres de escape etc. options afeta o comportamento dessa função de forma semelhante à forma como as opções que você pode passar para o COPY comando no PostgreSQL afetam seu comportamento.

Tipo de retorno

SETOF record SETOF anyelement

azure_storage.blob_put

Função que permite exportar dados carregando arquivos em um contêiner de blob em uma conta de Armazenamento do Azure. O conteúdo dos arquivos é produzido a partir de linhas no PostgreSQL.

Observação

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

Há uma versão sobrecarregada da função, que encoder contém o parâmetro que permite especificar o codificador a ser usado quando ele não pode ser inferido da extensão do path parâmetro ou quando você deseja substituir o inferido.

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

Há uma versão sobrecarregada da função que também contém um compression parâmetro que permite especificar a compactação a ser usada quando ela não pode ser inferida da extensão do path parâmetro ou quando você deseja substituir o inferido.

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

Há uma versão sobrecarregada da função que também contém um options parâmetro para lidar com cabeçalhos personalizados, separadores personalizados, caracteres de escape etc. options funciona de maneira semelhante às opções que podem ser passadas para o COPY comando no PostgreSQL.

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

Permissões

Argumentos

account_name

nome_do_container

O URI de um contêiner é semelhante a: https://myaccount.blob.core.windows.net/mycontainer

caminho

text o nome completo do blob.

tupla

record a definição da estrutura de saída do registro.

codificador

text a especificação do formato de blob. Pode ser definido como qualquer um dos seguintes valores:

Formato	Inadimplência	Descrição
`auto`	`true`	Infere o valor com base na última série de caracteres atribuídos ao nome do blob. Se o nome do blob terminar com `.csv` ou `.csv.gz`, ele pressupõe `csv`. Se terminar com `.tsv` ou `.tsv.gz`, ele pressupõe `tsv`. Se terminar com `.json`, `.json.gz`, , `.xml`, `.xml.gz.txt`ou `.txt.gz`, ele pressupõe `text`.
`binary`		Formato copy do PostgreSQL binário.
`csv`		Formato de valores separados por vírgulas usado pelo PostgreSQL COPY.
`parquet`		Formato Parquet.
`text` \| `xml` \| `json`		Um arquivo que contém um único valor de texto.
`tsv`		Valores separados por tabulação, o formato padrão postgreSQL COPY.

compactação

text a especificação do tipo de compactação. Pode ser definido como qualquer um dos seguintes valores:

Formato	Inadimplência	Descrição
`auto`	`true`	Infere o valor com base na última série de caracteres atribuídos ao nome do blob. Se o nome do blob terminar, `.gz`ele pressupõe `gzip`. Caso contrário, ele pressupõe `none`.
`brotli`		Força o uso do algoritmo de compactação brotli para compactar o blob. Compatível apenas com `parquet` o codificador.
`gzip`		Força o uso do algoritmo de compactação gzip para compactar o blob.
`lz4`		Força o uso do algoritmo de compactação lz4 para compactar o blob. Compatível apenas com `parquet` o codificador.
`none`		Força a não compactar o blob.
`snappy`		Força o uso de algoritmo de compactação rápida para compactar o blob. Compatível apenas com `parquet` o codificador.
`zstd`		Força o uso do algoritmo de compactação zstd para compactar o blob. Compatível apenas com `parquet` o codificador.

A extensão não dá suporte a nenhum outro tipo de compactação.

Opções

Tipo de retorno

VOID

azure_storage.options_copy

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro dentro blob_get. Ele atua como uma função auxiliar para options_parquet, options_csv_get, options_tsv e 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);

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

delimitador

text o caractere que separa colunas em cada linha (linha) do arquivo. Deve ser um único caractere de 1 byte. Embora essa função dê suporte a delimitadores de qualquer número de caracteres, se você tentar usar mais de um único caractere de 1 byte, o PostgreSQL relatará um COPY delimiter must be a single one-byte character erro.

null_string

text a cadeia de caracteres que representa um valor nulo. O padrão é \N (backslash-N) no formato de texto e uma cadeia de caracteres vazia sem aspas no formato CSV. Você pode preferir uma cadeia de caracteres vazia mesmo no formato de texto para casos em que você não deseja distinguir nulos de cadeias de caracteres vazias.

boolean sinalizador que indica se o arquivo contém uma linha de cabeçalho com os nomes de cada coluna no arquivo. Na saída, a linha inicial contém os nomes de coluna da tabela.

cota

text o caractere de aspas a ser usado quando um valor de dados é citado. O padrão é aspas duplas. Deve ser um único caractere de 1 byte. Embora essa função dê suporte a delimitadores de qualquer número de caracteres, se você tentar usar mais de um único caractere de 1 byte, o PostgreSQL relatará um COPY quote must be a single one-byte character erro.

escapar

text o caractere que deve aparecer antes de um caractere de dados que corresponde ao valor QUOTE. O padrão é o mesmo que o valor QUOTE (de modo que o caractere de aspas seja duplicado se ele aparecer nos dados). Deve ser um único caractere de 1 byte. Embora essa função dê suporte a delimitadores de qualquer número de caracteres, se você tentar usar mais de um único caractere de 1 byte, o PostgreSQL relatará um COPY escape must be a single one-byte character erro.

force_quote

text[] força as aspas a serem usadas para todos os valores não NULL em cada coluna especificada. A saída NULL nunca é entre aspas. Se * for especificado, valores não NULL serão citados em todas as colunas.

force_not_null

text[] não corresponde aos valores das colunas especificadas com a cadeia de caracteres nula. No caso padrão em que a cadeia de caracteres nula está vazia, isso significa que os valores vazios são lidos como cadeias de caracteres de comprimento zero em vez de nulos, mesmo quando não são citados.

force_null

text[] corresponda aos valores das colunas especificadas em relação à cadeia de caracteres nula, mesmo que entre aspas e, se uma correspondência for encontrada, defina o valor como NULL. No caso padrão em que a cadeia de caracteres nula está vazia, ela converte uma cadeia de caracteres vazia entre aspas em NULL.

content_encoding

text nome da codificação com a qual o arquivo é codificado. Se a opção for omitida, a codificação do cliente atual será usada.

Tipo de retorno

jsonb

azure_storage.options_parquet

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro dentro blob_gete é útil para decodificar o conteúdo de um arquivo parquet.

azure_storage.options_parquet();

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

Tipo de retorno

jsonb

azure_storage.options_csv_get

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro dentro blob_gete é útil para decodificar o conteúdo de um arquivo 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);

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

delimitador

null_string

cabeçalho

boolean sinalizador que indica se o arquivo contém uma linha de cabeçalho com os nomes de cada coluna no arquivo. Na saída, a linha inicial contém os nomes de coluna da tabela.

cota

escapar

force_not_null

force_null

content_encoding

text nome da codificação com a qual o arquivo é codificado. Se a opção for omitida, a codificação do cliente atual será usada.

Tipo de retorno

jsonb

azure_storage.options_tsv

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro dentro blob_gete é útil para decodificar o conteúdo de um arquivo tsv.

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

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

delimitador

null_string

content_encoding

text nome da codificação com a qual o arquivo é codificado. Se a opção for omitida, a codificação do cliente atual será usada.

Tipo de retorno

jsonb

azure_storage.options_binary

Função que atua como uma função de utilitário, que pode ser chamada como um parâmetro dentro blob_gete é útil para decodificar o conteúdo de um arquivo binário.

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

Permissões

Qualquer usuário ou função pode invocar essa função.

Argumentos

content_encoding

text nome da codificação com a qual o arquivo é codificado. Se a opção for omitida, a codificação do cliente atual será usada.

Tipo de retorno

jsonb

Comentários

Esta página foi útil?

Last updated on 2025-11-19

Compartilhar via

Referência de funções fornecidas pela extensão de Armazenamento do Azure no Banco de Dados do Azure para PostgreSQL

azure_storage.account_add

Permissões

Argumentos

account_name_p

account_key_p

account_config

Tipo de retorno

azure_storage.account_options_managed_identity

Permissões

Argumentos

nome

tipo

Tipo de retorno

azure_storage.account_options_credentials

Permissões

Argumentos

nome

credenciais

tipo

Tipo de retorno

azure_storage.account_options

Permissões

Argumentos

nome

auth_type

storage_type

credenciais

Tipo de retorno

azure_storage.account_remove

Permissões

Argumentos

account_name_p

Tipo de retorno

azure_storage.account_user_add

Permissões

Argumentos

account_name_p

user_p

Tipo de retorno

azure_storage.account_user_remove

Permissões

Argumentos

account_name_p

user_p

Tipo de retorno

azure_storage.account_list

Permissões

Argumentos

Tipo de retorno

azure_storage.blob_list

Permissões

Argumentos

account_name

nome_do_container

prefixo

Tipo de retorno

caminho

Bytes

last_modified

etag

content_type

content_encoding

content_hash

azure_storage.blob_get

Permissões

Argumentos

account_name

nome_do_container

caminho

Rec

decodificador

compactação

Opções

Tipo de retorno

azure_storage.blob_put

Permissões

Argumentos

account_name