Partager via


Référence des fonctions fournies par l’extension Stockage Azure dans Azure Database pour PostgreSQL

Voici la liste des fonctions fournies par l’extension Stockage Azure :

azure_storage.account_add

Fonction qui permet d’ajouter un compte de stockage et sa clé d’accès associée à la liste des comptes de stockage auxquels l’extension azure_storage peut accéder.

Si un appel précédent de cette fonction a déjà ajouté la référence à ce compte de stockage, il n’ajoute pas de nouvelle entrée, mais met à jour plutôt la clé d’accès de l’entrée existante.

Remarque

Cette fonction ne valide pas si le nom du compte référencé existe ou s’il est accessible avec la clé d’accès fournie. Toutefois, il vérifie que le nom du compte de stockage est valide, conformément aux règles de validation de nommage imposées sur les comptes de stockage Azure.

azure_storage.account_add(account_name_p text, account_key_p text);

Il existe une version surchargée de cette fonction, qui accepte un account_config paramètre qui encapsule le nom du compte de stockage Azure référencé et tous les paramètres requis tels que le type d’authentification, le type de compte ou les informations d’identification de stockage.

azure_storage.account_add(account_config jsonb);

Autorisations

Doit être membre de azure_storage_admin.

Les arguments

account_name_p

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

account_key_p

text valeur de l’une des clés d’accès pour le compte de stockage. Vos clés d’accès au stockage Blob Azure sont similaires à un mot de passe racine pour votre compte de stockage. Veillez toujours à protéger vos clés d’accès. Utilisez Azure Key Vault pour gérer et effectuer la rotation de vos clés en toute sécurité. La clé de compte est stockée dans une table accessible uniquement par le superutilisateur. Les utilisateurs disposant du azure_storage_admin rôle peuvent interagir avec cette table via des fonctions. Pour voir quels comptes de stockage sont ajoutés, utilisez la fonction azure_storage.account_list.

account_config

jsonb le nom du compte stockage Azure et tous les paramètres requis, tels que le type d’authentification, le type de compte ou les informations d’identification de stockage. Nous vous recommandons d’utiliser les fonctions utilitaires azure_storage.account_options_managed_identity, azure_storage.account_options_credentials ou azure_storage.account_options pour créer les valeurs valides qui doivent être passées en tant qu’argument.

Type de retour

VOID

azure_storage.account_options_managed_identity

Fonction qui agit comme une fonction utilitaire, qui peut être appelée en tant que paramètre dans azure_storage.account_add, et est utile pour produire une valeur valide pour l’argument, lors de l’utilisation account_config d’une identité managée affectée par le système pour interagir avec le compte de stockage Azure.

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

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

nom

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

type

azure_storage.storage_type valeur de l’un des types de stockage pris en charge. Seule la valeur prise en charge est blob.

Type de retour

jsonb

azure_storage.account_options_credentials

Fonction qui agit comme une fonction utilitaire, qui peut être appelée en tant que paramètre dans azure_storage.account_add, et est utile pour produire une valeur valide pour l’argument, lors de l’utilisation account_config d’une clé d’accès Stockage Azure pour interagir avec le compte de stockage Azure.

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

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

nom

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

credentials

text valeur de l’une des clés d’accès pour le compte de stockage. Vos clés d’accès au stockage Blob Azure sont similaires à un mot de passe racine pour votre compte de stockage. Veillez toujours à protéger vos clés d’accès. Utilisez Azure Key Vault pour gérer et effectuer la rotation de vos clés en toute sécurité. La clé de compte est stockée dans une table accessible uniquement par le superutilisateur. Les utilisateurs disposant du azure_storage_admin rôle peuvent interagir avec cette table via des fonctions. Pour voir quels comptes de stockage sont ajoutés, utilisez la fonction azure_storage.account_list.

type

azure_storage.storage_type valeur de l’un des types de stockage pris en charge. Seule la valeur prise en charge est blob.

Type de retour

jsonb

azure_storage.account_options

Fonction qui agit en tant que fonction utilitaire, qui peut être appelée en tant que paramètre dans azure_storage.account_add, et est utile pour produire une valeur valide pour l’argument, lors de l’utilisation account_config d’une clé d’accès Stockage Azure ou d’une identité managée affectée par le système pour interagir avec le compte stockage Azure.

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

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

nom

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

auth_type

azure_storage.auth_type valeur de l’un des types de stockage pris en charge. Seules les valeurs prises en charge sont access-key, et managed-identity.

storage_type

azure_storage.storage_type valeur de l’un des types de stockage pris en charge. Seule la valeur prise en charge est blob.

credentials

text valeur de l’une des clés d’accès pour le compte de stockage. Vos clés d’accès au stockage Blob Azure sont similaires à un mot de passe racine pour votre compte de stockage. Veillez toujours à protéger vos clés d’accès. Utilisez Azure Key Vault pour gérer et effectuer la rotation de vos clés en toute sécurité. La clé de compte est stockée dans une table accessible uniquement par le superutilisateur. Les utilisateurs disposant du azure_storage_admin rôle peuvent interagir avec cette table via des fonctions. Pour voir quels comptes de stockage sont ajoutés, utilisez la fonction azure_storage.account_list.

Type de retour

jsonb

azure_storage.account_remove

Fonction qui permet de supprimer un compte de stockage et sa clé d’accès associée dans la liste des comptes de stockage auxquels l’extension azure_storage peut accéder.

azure_storage.account_remove(account_name_p text);

Autorisations

Doit être membre de azure_storage_admin.

Les arguments

account_name_p

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

Type de retour

VOID

azure_storage.account_user_add

Fonction qui permet d’accorder à un utilisateur ou un rôle PostgreSQL l’accès à un compte de stockage via les fonctions fournies par l’extension azure_storage .

Remarque

L’exécution de cette fonction réussit uniquement si le compte de stockage, dont le nom est passé en tant que premier argument, a déjà été créé à l’aide de azure_storage.account_add, et si l’utilisateur ou le rôle, dont le nom est passé en tant que deuxième argument, existe déjà.

azure_storage.account_add(account_name_p text, user_p regrole);

Autorisations

Doit être membre de azure_storage_admin.

Les arguments

account_name_p

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

user_p

regrole nom d’un utilisateur ou d’un rôle PostgreSQL disponible sur le serveur.

Type de retour

VOID

azure_storage.account_user_remove

Fonction qui permet de révoquer un utilisateur ou un rôle PostgreSQL d’accéder à un compte de stockage via les fonctions fournies par l’extension azure_storage .

Remarque

L’exécution de cette fonction réussit uniquement si le compte de stockage dont le nom est passé en tant que premier argument a déjà été créé à l’aide de azure_storage.account_add, et si l’utilisateur ou le rôle dont le nom est passé en tant que deuxième argument existe toujours. Lorsqu’un utilisateur ou un rôle est supprimé du serveur, en exécutant DROP USER | ROLE, les autorisations accordées sur n’importe quelle référence aux comptes de stockage Azure sont également supprimées automatiquement.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Autorisations

Doit être membre de azure_storage_admin.

Les arguments

account_name_p

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

user_p

regrole nom d’un utilisateur ou d’un rôle PostgreSQL disponible sur le serveur.

Type de retour

VOID

azure_storage.account_list

Fonction qui répertorie les noms des comptes de stockage qui ont été configurés via la fonction azure_storage.account_add , ainsi que les utilisateurs ou rôles PostgreSQL auxquels des autorisations sont accordées pour interagir avec ce compte de stockage via les fonctions fournies par l’extension azure_storage .

azure_storage.account_list();

Autorisations

Doit être membre de azure_storage_admin.

Les arguments

Cette fonction ne prend aucun argument.

Type de retour

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) Une table à quatre colonnes avec la liste des comptes de stockage Azure ajoutés, le type d’authentification utilisé pour interagir avec chaque compte, le type de stockage et la liste des utilisateurs ou rôles PostgreSQL auxquels l’accès est accordé.

azure_storage.blob_list

Fonction qui répertorie les noms et autres propriétés (taille, lastModified, eTag, contentType, contentEncoding et contentHash) des objets blob stockés dans le conteneur donné du compte de stockage référencé.

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

Autorisations

L’utilisateur ou le rôle appelant cette fonction doit être ajouté à la liste autorisée pour l’utilisateur ou le account_name rôle référencé, en exécutant azure_storage.account_user_add. Les membres sont azure_storage_admin automatiquement autorisés à référencer tous les comptes de stockage Azure dont les références ont été ajoutées à l’aide de azure_storage.account_add.

Les arguments

account_name

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

nom_du_conteneur

text nom d’un conteneur. Un conteneur organise un ensemble d’objets blob, similaire à un répertoire dans un système de fichiers. Un compte de stockage peut inclure un nombre illimité de conteneurs, et un conteneur peut stocker un nombre illimité de blobs. Un nom de conteneur doit être un nom DNS (Domain Name System) valide, car il fait partie de l’URI unique utilisé pour traiter le conteneur ou ses objets blob. Lorsque vous nommez un conteneur, veillez à suivre ces règles.

L’URI d’un conteneur est similaire à : https://myaccount.blob.core.windows.net/mycontainer

préfixe

text lorsqu’elle est spécifiée, la fonction retourne les objets blob dont les noms commencent par la valeur fournie dans ce paramètre. La valeur par défaut est une chaîne vide.

Type de retour

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) une table avec un enregistrement par objet blob retourné, y compris le nom complet de l’objet blob et d’autres propriétés.

chemin

text nom complet de l’objet blob.

octets

bigint taille de l’objet blob en octets.

last_modified

timestamp with time zonedate et heure de la dernière modification de l’objet blob. Toute opération qui modifie l’objet blob, notamment une mise à jour des métadonnées ou des propriétés de l’objet blob, modifie l’heure de la dernière modification de l’objet blob.

etag

text la propriété ETag est utilisée pour l’accès concurrentiel optimiste pendant les mises à jour. Il ne s’agit pas d’un horodatage, car il existe une autre propriété appelée Timestamp qui stocke la dernière fois qu’un enregistrement a été mis à jour. Par exemple, si vous chargez une entité et souhaitez la mettre à jour, l’ETag doit correspondre à ce qui est actuellement stocké. La définition de l’ETag appropriée est importante, car si plusieurs utilisateurs modifient le même élément, vous ne souhaitez pas qu’ils remplacent les modifications des autres.

content_type

text type de contenu spécifié pour l’objet blob. Le type de contenu par défaut est application/octet-stream.

content_encoding

text la propriété Content-Encoding d’un objet blob que stockage Azure vous permet de définir. Pour le contenu compressé, vous pouvez définir la propriété sur Gzip. Lorsque le navigateur accède au contenu, il décompose automatiquement le contenu.

content_hash

text hachage utilisé pour vérifier l’intégrité de l’objet blob pendant le transport. Lorsque cet en-tête est spécifié, le service de stockage vérifie le hachage fourni avec un contenu calculé. Si les deux hachages ne correspondent pas, l'opération échoue avec le code d'erreur 400 (Demande incorrecte).

azure_storage.blob_get

Fonction qui permet l’importation de données. Il télécharge un fichier à partir d’un conteneur d’objets blob dans un compte de stockage Azure. Ensuite, il traduit le contenu en lignes, qui peut être consommé et traité avec des constructions de langage SQL. Cette fonction ajoute la prise en charge du filtrage et de la manipulation des données extraites du conteneur d’objets blob avant de l’importer.

Remarque

Avant d’essayer d’accéder au conteneur pour le compte de stockage référencé, cette fonction vérifie si les noms du compte de stockage et du conteneur transmis en tant qu’arguments sont valides en fonction des règles de validation d’affectation de noms imposées sur les comptes de stockage Azure. Si l’un d’eux n’est pas valide, une erreur est générée.

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

Il existe une version surchargée de cette fonction, qui accepte un rec paramètre qui vous permet de définir facilement l’enregistrement de format de sortie.

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

Autorisations

L’utilisateur ou le rôle appelant cette fonction doit être ajouté à la liste autorisée pour l’utilisateur ou le account_name rôle référencé, en exécutant azure_storage.account_user_add. Les membres sont azure_storage_admin automatiquement autorisés à référencer tous les comptes de stockage Azure dont les références ont été ajoutées à l’aide de azure_storage.account_add.

Les arguments

account_name

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

nom_du_conteneur

text nom d’un conteneur. Un conteneur organise un ensemble d’objets blob, similaire à un répertoire dans un système de fichiers. Un compte de stockage peut inclure un nombre illimité de conteneurs, et un conteneur peut stocker un nombre illimité de blobs. Un nom de conteneur doit être un nom DNS (Domain Name System) valide, car il fait partie de l’URI unique utilisé pour traiter le conteneur ou ses objets blob. Lorsque vous nommez un conteneur, veillez à suivre ces règles.

L’URI d’un conteneur est similaire à : https://myaccount.blob.core.windows.net/mycontainer

chemin

text nom complet de l’objet blob.

Rec

anyelement définition de la structure de sortie d’enregistrement.

décodeur

text spécification du format d’objet blob. Peut être défini sur l’une des valeurs suivantes :

Format Par défaut Description
auto true Déduit la valeur en fonction de la dernière série de caractères attribués au nom de l’objet blob. Si le nom de l’objet blob se termine .parquetpar , il suppose parquet. Si elle se termine par .csv ou .csv.gz, elle part du principe csv. Si elle se termine par .tsv ou .tsv.gz, elle part du principe tsv. Si se termine par .json, , .json.gz.xml, .xml.gz, .txtou .txt.gz, il suppose text.
binary Format COPY PostgreSQL binaire.
csv Format de valeurs séparées par des virgules utilisées par PostgreSQL COPY.
parquet Format Parquet.
text | xml | json Fichier contenant une valeur de texte unique.
tsv Valeurs séparées par des onglets, format PostgreSQL COPY par défaut.
compression

text spécification du type de compression. Peut être défini sur l’une des valeurs suivantes :

Format Par défaut Description
auto true Déduit la valeur en fonction de la dernière série de caractères attribués au nom de l’objet blob. Si le nom de l’objet blob se termine .gzpar , il suppose gzip. Sinon, il suppose none.
brotli Force l’utilisation de l’algorithme de compression brotli pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .
gzip Force l’utilisation de l’algorithme de compression gzip pour compresser l’objet blob.
lz4 Force l’utilisation de l’algorithme de compression lz4 pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .
none Force à ne pas compresser l’objet blob.
snappy Force l’utilisation de l’algorithme de compression snappy pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .
zstd Force l’utilisation de l’algorithme de compression zstd pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .

L’extension ne prend pas en charge d’autres types de compression.

Options

jsonb les paramètres qui définissent la gestion des en-têtes personnalisés, des séparateurs personnalisés, des caractères d’échappement, etc. options affecte le comportement de cette fonction d’une manière similaire à la façon dont les options que vous pouvez transmettre à la COPY commande dans PostgreSQL affectent son comportement.

Type de retour

SETOF record SETOF anyelement

azure_storage.blob_put

Fonction qui permet d’exporter des données, en chargeant des fichiers dans un conteneur d’objets blob dans un compte de stockage Azure. Le contenu des fichiers est généré à partir de lignes dans PostgreSQL.

Remarque

Avant d’essayer d’accéder au conteneur pour le compte de stockage référencé, cette fonction vérifie si les noms du compte de stockage et du conteneur transmis en tant qu’arguments sont valides en fonction des règles de validation d’affectation de noms imposées sur les comptes de stockage Azure. Si l’un d’eux n’est pas valide, une erreur est générée.

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

Il existe une version surchargée de la fonction, contenant encoder un paramètre qui vous permet de spécifier l’encodeur à utiliser lorsqu’il ne peut pas être déduit à partir de l’extension du path paramètre, ou lorsque vous souhaitez remplacer celui déduit.

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

Il existe une version surchargée de la fonction qui contient également un compression paramètre qui vous permet de spécifier la compression à utiliser lorsqu’elle ne peut pas être déduite à partir de l’extension path du paramètre, ou lorsque vous souhaitez remplacer celle déduite.

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

Il existe une version surchargée de fonction qui contient également un options paramètre pour la gestion des en-têtes personnalisés, des séparateurs personnalisés, des caractères d’échappement, etc. options fonctionne de la même manière que les options qui peuvent être passées à la COPY commande dans PostgreSQL.

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

Autorisations

L’utilisateur ou le rôle appelant cette fonction doit être ajouté à la liste autorisée pour l’utilisateur ou le account_name rôle référencé, en exécutant azure_storage.account_user_add. Les membres sont azure_storage_admin automatiquement autorisés à référencer tous les comptes de stockage Azure dont les références ont été ajoutées à l’aide de azure_storage.account_add.

Les arguments

account_name

text nom du compte de stockage d’objets blob Azure qui contient tous vos objets : objets blob, fichiers, files d’attente et tables. Le compte de stockage fournit un espace de noms unique accessible n’importe où dans le monde via HTTPS.

nom_du_conteneur

text nom d’un conteneur. Un conteneur organise un ensemble d’objets blob, similaire à un répertoire dans un système de fichiers. Un compte de stockage peut inclure un nombre illimité de conteneurs, et un conteneur peut stocker un nombre illimité de blobs. Un nom de conteneur doit être un nom DNS (Domain Name System) valide, car il fait partie de l’URI unique utilisé pour traiter le conteneur ou ses objets blob. Lorsque vous nommez un conteneur, veillez à suivre ces règles.

L’URI d’un conteneur est similaire à : https://myaccount.blob.core.windows.net/mycontainer

chemin

text nom complet de l’objet blob.

tuple

record définition de la structure de sortie d’enregistrement.

codeur

text spécification du format d’objet blob. Peut être défini sur l’une des valeurs suivantes :

Format Par défaut Description
auto true Déduit la valeur en fonction de la dernière série de caractères attribués au nom de l’objet blob. Si le nom de l’objet blob se termine .csv par ou .csv.gz, il suppose csv. Si elle se termine par .tsv ou .tsv.gz, elle part du principe tsv. Si se termine par .json, , .json.gz.xml, .xml.gz, .txtou .txt.gz, il suppose text.
binary Format COPY PostgreSQL binaire.
csv Format de valeurs séparées par des virgules utilisées par PostgreSQL COPY.
parquet Format Parquet.
text | xml | json Fichier contenant une valeur de texte unique.
tsv Valeurs séparées par des onglets, format PostgreSQL COPY par défaut.
compression

text spécification du type de compression. Peut être défini sur l’une des valeurs suivantes :

Format Par défaut Description
auto true Déduit la valeur en fonction de la dernière série de caractères attribués au nom de l’objet blob. Si le nom de l’objet blob se termine .gzpar , il suppose gzip. Sinon, il suppose none.
brotli Force l’utilisation de l’algorithme de compression brotli pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .
gzip Force l’utilisation de l’algorithme de compression gzip pour compresser l’objet blob.
lz4 Force l’utilisation de l’algorithme de compression lz4 pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .
none Force à ne pas compresser l’objet blob.
snappy Force l’utilisation de l’algorithme de compression snappy pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .
zstd Force l’utilisation de l’algorithme de compression zstd pour compresser l’objet blob. Uniquement pris en charge par l’encodeur parquet .

L’extension ne prend pas en charge d’autres types de compression.

Options

jsonb les paramètres qui définissent la gestion des en-têtes personnalisés, des séparateurs personnalisés, des caractères d’échappement, etc. options affecte le comportement de cette fonction d’une manière similaire à la façon dont les options que vous pouvez transmettre à la COPY commande dans PostgreSQL affectent son comportement.

Type de retour

VOID

azure_storage.options_copy

Fonction qui agit en tant que fonction utilitaire, qui peut être appelée en tant que paramètre dans blob_get. Il agit comme une fonction d’assistance pour options_parquet, options_csv_get, options_tsv et 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);

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

délimiteur

text caractère qui sépare les colonnes dans chaque ligne (ligne) du fichier. Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY delimiter must be a single one-byte character erreur.

null_string

text chaîne qui représente une valeur Null. La valeur par défaut est \N (barre oblique inverse-N) au format texte et une chaîne vide sans guillemet au format CSV. Vous préférerez peut-être une chaîne vide même au format texte pour les cas où vous ne souhaitez pas distinguer les valeurs Null des chaînes vides.

boolean indicateur qui indique si le fichier contient une ligne d’en-tête avec les noms de chaque colonne du fichier. En sortie, la ligne initiale contient les noms de colonnes de la table.

citer

text caractère de guillemet à utiliser lorsqu’une valeur de données est entre guillemets. La valeur par défaut est entre guillemets doubles. Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY quote must be a single one-byte character erreur.

échappement

text caractère qui doit apparaître avant un caractère de données qui correspond à la valeur QUOTE. La valeur par défaut est identique à la valeur QUOTE (afin que le caractère de guillemet soit doublé s’il apparaît dans les données). Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY escape must be a single one-byte character erreur.

force_quote

text[] force le guillemet à utiliser pour toutes les valeurs non NULL dans chaque colonne spécifiée. La sortie NULL n’est jamais entre guillemets. Si * est spécifié, les valeurs non NULL sont entre guillemets dans toutes les colonnes.

force_not_null

text[] ne correspondent pas aux valeurs des colonnes spécifiées par rapport à la chaîne Null. Dans le cas par défaut où la chaîne Null est vide, cela signifie que les valeurs vides sont lues en tant que chaînes de longueur nulle plutôt que null, même lorsqu’elles ne sont pas entre guillemets.

force_null

text[] correspond aux valeurs des colonnes spécifiées par rapport à la chaîne Null, même si elle est entre guillemets et si une correspondance est trouvée, définissez la valeur sur NULL. Dans le cas par défaut où la chaîne Null est vide, elle convertit une chaîne vide entre guillemets en null.

content_encoding

text nom de l’encodage avec lequel le fichier est encodé. Si l’option est omise, l’encodage client actuel est utilisé.

Type de retour

jsonb

azure_storage.options_parquet

Fonction qui agit comme une fonction utilitaire, qui peut être appelée en tant que paramètre dans blob_get, et est utile pour décoder le contenu d’un fichier Parquet.

azure_storage.options_parquet();

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

Type de retour

jsonb

azure_storage.options_csv_get

Fonction qui agit en tant que fonction utilitaire, qui peut être appelée en tant que paramètre dans blob_get, et est utile pour décoder le contenu d’un fichier 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);

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

délimiteur

text caractère qui sépare les colonnes dans chaque ligne (ligne) du fichier. Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY delimiter must be a single one-byte character erreur.

null_string

text chaîne qui représente une valeur Null. La valeur par défaut est \N (barre oblique inverse-N) au format texte et une chaîne vide sans guillemet au format CSV. Vous préférerez peut-être une chaîne vide même au format texte pour les cas où vous ne souhaitez pas distinguer les valeurs Null des chaînes vides.

en-tête

boolean indicateur qui indique si le fichier contient une ligne d’en-tête avec les noms de chaque colonne du fichier. En sortie, la ligne initiale contient les noms de colonnes de la table.

citer

text caractère de guillemet à utiliser lorsqu’une valeur de données est entre guillemets. La valeur par défaut est entre guillemets doubles. Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY quote must be a single one-byte character erreur.

échappement

text caractère qui doit apparaître avant un caractère de données qui correspond à la valeur QUOTE. La valeur par défaut est identique à la valeur QUOTE (afin que le caractère de guillemet soit doublé s’il apparaît dans les données). Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY escape must be a single one-byte character erreur.

force_not_null

text[] ne correspondent pas aux valeurs des colonnes spécifiées par rapport à la chaîne Null. Dans le cas par défaut où la chaîne Null est vide, cela signifie que les valeurs vides sont lues en tant que chaînes de longueur nulle plutôt que null, même lorsqu’elles ne sont pas entre guillemets.

force_null

text[] correspond aux valeurs des colonnes spécifiées par rapport à la chaîne Null, même si elle est entre guillemets et si une correspondance est trouvée, définissez la valeur sur NULL. Dans le cas par défaut où la chaîne Null est vide, elle convertit une chaîne vide entre guillemets en null.

content_encoding

text nom de l’encodage avec lequel le fichier est encodé. Si l’option est omise, l’encodage client actuel est utilisé.

Type de retour

jsonb

azure_storage.options_tsv

Fonction qui agit en tant que fonction utilitaire, qui peut être appelée en tant que paramètre dans blob_get, et est utile pour décoder le contenu d’un fichier tsv.

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

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

délimiteur

text caractère qui sépare les colonnes dans chaque ligne (ligne) du fichier. Il doit s’agir d’un caractère de 1 octet unique. Bien que cette fonction prenne en charge les délimiteurs d’un nombre quelconque de caractères, si vous essayez d’utiliser plus d’un seul caractère de 1 octet, PostgreSQL signale une COPY delimiter must be a single one-byte character erreur.

null_string

text chaîne qui représente une valeur Null. La valeur par défaut est \N (barre oblique inverse-N) au format texte et une chaîne vide sans guillemet au format CSV. Vous préférerez peut-être une chaîne vide même au format texte pour les cas où vous ne souhaitez pas distinguer les valeurs Null des chaînes vides.

content_encoding

text nom de l’encodage avec lequel le fichier est encodé. Si l’option est omise, l’encodage client actuel est utilisé.

Type de retour

jsonb

azure_storage.options_binary

Fonction qui agit en tant que fonction utilitaire, qui peut être appelée en tant que paramètre dans blob_get, et est utile pour décoder le contenu d’un fichier binaire.

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

Autorisations

Tout utilisateur ou rôle peut appeler cette fonction.

Les arguments

content_encoding

text nom de l’encodage avec lequel le fichier est encodé. Si l’option est omise, l’encodage client actuel est utilisé.

Type de retour

jsonb