Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
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.
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_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