Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'elenco seguente mostra le funzioni fornite dall'estensione Archiviazione di Azure:
azure_storage.account_add
Funzione che aggiunge un account di archiviazione e la chiave di accesso associata all'elenco di account di archiviazione a cui l'estensione azure_storage può accedere.
Se una chiamata precedente di questa funzione ha già aggiunto il riferimento a questo account di archiviazione, non aggiunge una nuova voce ma aggiorna invece la chiave di accesso della voce esistente.
Annotazioni
Questa funzione non convalida se il nome dell'account di riferimento esiste o se è accessibile con la chiave di accesso fornita. Tuttavia, convalida che il nome dell'account di archiviazione sia valido, in base alle regole di convalida dei nomi imposte agli account di archiviazione di Azure.
azure_storage.account_add(account_name_p text, account_key_p text);
Una versione di overload di questa funzione accetta un account_config parametro che incapsula il nome dell'account di Archiviazione di Azure a cui si fa riferimento e tutte le impostazioni necessarie, ad esempio il tipo di autenticazione, il tipo di account o le credenziali di archiviazione.
azure_storage.account_add(account_config jsonb);
Permissions
Deve essere un membro di azure_storage_admin.
Arguments
account_name_p
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
account_key_p
text valore di una delle chiavi di accesso per l'account di archiviazione. Le chiavi di accesso dell'archiviazione BLOB di Azure sono simili a una password radice per l'account di archiviazione. Fare sempre attenzione a proteggere le chiavi di accesso. Usare Azure Key Vault per gestire e ruotare le chiavi in modo sicuro. La chiave dell'account viene archiviata in una tabella a cui può accedere solo l'utente con privilegi avanzati. Gli utenti a cui è stato concesso il azure_storage_admin ruolo possono interagire con questa tabella tramite funzioni. Per visualizzare gli account di archiviazione aggiunti, usare la funzione azure_storage.account_list.
account_config
jsonb il nome dell'account di archiviazione di Azure e tutte le impostazioni necessarie, ad esempio il tipo di autenticazione, il tipo di account o le credenziali di archiviazione. Usare le funzioni di utilità azure_storage.account_options_managed_identity, azure_storage.account_options_credentials o azure_storage.account_options per creare uno dei valori validi che è necessario passare come argomento.
Tipo di ritorno
VOID
azure_storage.account_encrypt_existing_credentials
Funzione che analizza un elenco di account di archiviazione esistenti aggiunti usando azure_storage.account_add nelle versioni precedenti dell'estensione. Queste versioni archiviano credenziali non crittografate. Questa funzione crittografa tutte le credenziali usando la chiave archiviata in azure_storage.credential_encryption_key. Il valore di è limitato a livello di azure_storage.credential_encryption_key server. Pertanto, se si crea l'estensione Archiviazione di Azure in più database nello stesso server, la stessa chiave di crittografia crittografa tutte le credenziali riservate archiviate dall'estensione, indipendentemente dal database in cui sono archiviate.
Important
Se si crea l'estensione Archiviazione di Azure in più database dello stesso server, è necessario eseguire la azure_storage.account_encrypt_existing_credentials funzione in ognuno di questi database.
azure_storage.account_encrypt_existing_credentials();
Permissions
Deve essere un membro di azure_storage_admin.
Arguments
Questa funzione non accetta argomenti.
Tipo di ritorno
bigint Numero di credenziali dell'account di archiviazione esistenti non crittografate prima dell'esecuzione della funzione e ora crittografate usando la chiave archiviata in azure_storage.credential_encryption_key.
azure_storage.account_options_managed_identity
Funzione che funge da funzione di utilità. Chiamarlo come parametro all'interno di azure_storage.account_add. Consente di creare un valore valido per l'argomento quando si usa un'identità account_config gestita assegnata dal sistema per interagire con l'account Archiviazione di Azure.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
nome
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
type
azure_storage.storage_type valore di uno dei tipi di archiviazione supportati. Il valore supportato è blob.
Tipo di ritorno
jsonb
azure_storage.account_options_credentials
Funzione di utilità che è possibile chiamare come parametro all'interno di azure_storage.account_add. Consente di creare un valore valido per l'argomento account_config quando si usa una chiave di accesso Archiviazione di Azure per interagire con l'account Archiviazione di Azure.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
nome
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
credentials
text valore di una delle chiavi di accesso per l'account di archiviazione. Le chiavi di accesso dell'archiviazione BLOB di Azure sono simili a una password radice per l'account di archiviazione. Fare sempre attenzione a proteggere le chiavi di accesso. Usare Azure Key Vault per gestire e ruotare le chiavi in modo sicuro. La chiave dell'account viene archiviata in una tabella a cui può accedere solo l'utente con privilegi avanzati. Gli utenti a cui è stato concesso il azure_storage_admin ruolo possono interagire con questa tabella tramite funzioni. Per visualizzare gli account di archiviazione aggiunti, usare la funzione azure_storage.account_list.
type
azure_storage.storage_type valore di uno dei tipi di archiviazione supportati. Il valore supportato è blob.
Tipo di ritorno
jsonb
azure_storage.account_options
Funzione di utilità che è possibile chiamare come parametro all'interno di azure_storage.account_add. Consente di creare un valore valido per l'argomento account_config quando si usa una chiave di accesso Archiviazione di Azure o un'identità gestita assegnata dal sistema per interagire con l'account Archiviazione di Azure.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
nome
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
auth_type
azure_storage.auth_type valore di uno dei tipi di archiviazione supportati. I valori supportati sono access-key e managed-identity.
storage_type
azure_storage.storage_type valore di uno dei tipi di archiviazione supportati. Il valore supportato è blob.
credentials
text valore di una delle chiavi di accesso per l'account di archiviazione. Le chiavi di accesso dell'archiviazione BLOB di Azure sono simili a una password radice per l'account di archiviazione. Fare sempre attenzione a proteggere le chiavi di accesso. Usare Azure Key Vault per gestire e ruotare le chiavi in modo sicuro. La chiave dell'account viene archiviata in una tabella a cui può accedere solo l'utente con privilegi avanzati. Gli utenti a cui è stato concesso il azure_storage_admin ruolo possono interagire con questa tabella tramite funzioni. Per visualizzare gli account di archiviazione aggiunti, usare la funzione azure_storage.account_list.
Tipo di ritorno
jsonb
azure_storage.account_remove
Funzione che rimuove un account di archiviazione e la chiave di accesso associata dall'elenco di account di archiviazione a cui l'estensione azure_storage può accedere.
azure_storage.account_remove(account_name_p text);
Permissions
Deve essere un membro di azure_storage_admin.
Arguments
account_name_p
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
Tipo di ritorno
VOID
azure_storage.account_user_add
Funzione che concede a un utente o a un ruolo PostgreSQL l'accesso a un account di archiviazione tramite le funzioni fornite dall'estensione azure_storage .
Annotazioni
L'esecuzione di questa funzione ha esito positivo solo se l'account di archiviazione, il cui nome passato come primo argomento, è già stato creato usando azure_storage.account_add e se l'utente o il ruolo, il cui nome viene passato come secondo argomento, esiste già.
azure_storage.account_add(account_name_p text, user_p regrole);
Permissions
Deve essere un membro di azure_storage_admin.
Arguments
account_name_p
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
user_p
regrole nome di un utente o di un ruolo PostgreSQL disponibile nel server.
Tipo di ritorno
VOID
azure_storage.account_user_remove
Funzione che revoca l'accesso a un utente o a un ruolo PostgreSQL a un account di archiviazione tramite le funzioni fornite dall'estensione azure_storage .
Annotazioni
L'esecuzione di questa funzione ha esito positivo solo se l'account di archiviazione il cui nome viene passato come primo argomento esiste già ed è stato creato usando azure_storage.account_add. Anche l'utente o il ruolo il cui nome viene passato come secondo argomento deve esistere.
Quando si elimina un utente o un ruolo dal server eseguendo DROP USER | ROLE, vengono rimosse automaticamente anche le autorizzazioni concesse per qualsiasi riferimento a Archiviazione di Azure account.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Permissions
Deve essere un membro di azure_storage_admin.
Arguments
account_name_p
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
user_p
regrole nome di un utente o di un ruolo PostgreSQL disponibile nel server.
Tipo di ritorno
VOID
azure_storage.account_list
Funzione che elenca i nomi degli account di archiviazione configurati tramite la funzione azure_storage.account_add , insieme agli utenti o ai ruoli PostgreSQL che dispongono delle autorizzazioni per interagire con tale account di archiviazione tramite le funzioni fornite dall'estensione azure_storage .
azure_storage.account_list();
Permissions
Deve essere un membro di azure_storage_admin.
Arguments
Questa funzione non accetta argomenti.
Tipo di ritorno
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[])una tabella a quattro colonne con l'elenco di account Archiviazione di Azure aggiunti, il tipo di autenticazione usato per interagire con ogni account, il tipo di archiviazione e l'elenco di utenti o ruoli postgreSQL che hanno accesso.
azure_storage.blob_list
Funzione che elenca i nomi e altre proprietà (size, lastModified, eTag, contentType, contentEncoding e contentHash) di BLOB archiviati nel contenitore specificato dell'account di archiviazione di riferimento.
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
Permissions
Aggiungere l'utente o il ruolo che richiama questa funzione all'elenco elementi consentiti per account_name eseguendo azure_storage.account_user_add. I membri di azure_storage_admin sono autorizzati automaticamente a fare riferimento a tutti gli account Archiviazione di Azure i cui riferimenti sono stati aggiunti tramite azure_storage.account_add.
Arguments
account_name
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
nome_del_contenitore
text nome di un contenitore. Un contenitore organizza un set di BLOB, simile a una directory in un file system. Un account di archiviazione può includere un numero illimitato di contenitori e un contenitore può archiviare un numero illimitato di BLOB.
Un nome contenitore deve essere un nome DNS (Domain Name System) valido, perché fa parte dell'URI univoco usato per indirizzare il contenitore o i relativi BLOB.
Quando si assegna un nome a un contenitore, seguire queste regole.
L'URI per un contenitore è simile al seguente: https://myaccount.blob.core.windows.net/mycontainer
prefix
text se specificato, la funzione restituisce i BLOB i cui nomi iniziano con il valore fornito in questo parametro. Il valore predefinito è una stringa vuota.
Tipo di ritorno
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) una tabella con un record per BLOB restituito, incluso il nome completo del BLOB e altre proprietà.
path
text nome completo del BLOB.
bytes
bigint dimensioni del BLOB in byte.
last_modified
timestamp with time zone data e ora dell'ultima modifica del BLOB. Le operazioni che comportano la modifica del BLOB, incluso un aggiornamento dei metadati o delle proprietà del Blob, comportano la modifica dell'ora dell'ultima modifica del Blob.
etag
text la proprietà ETag viene utilizzata per la concorrenza ottimistica durante gli aggiornamenti. Non è un timestamp perché esiste un'altra proprietà denominata Timestamp che archivia l'ultima volta che un record è stato aggiornato. Ad esempio, se si carica un'entità e si vuole aggiornarla, l'ETag deve corrispondere a ciò che è attualmente archiviato. L'impostazione dell'ETag appropriato è importante perché se sono presenti più utenti che modificano lo stesso elemento, non si vogliono sovrascrivere le modifiche dell'altro.
content_type
text tipo di contenuto specificato per il BLOB. Il tipo di contenuto predefinito è application/octet-stream.
content_encoding
text Proprietà Content-Encoding di un BLOB che Archiviazione di Azure consente di definire. Per il contenuto compresso, è possibile impostare la proprietà su Gzip. Quando il browser accede al contenuto, decomprime automaticamente il contenuto.
content_hash
text hash usato per verificare l'integrità del BLOB durante il trasporto. Quando si specifica questa intestazione, il servizio di archiviazione controlla l'hash fornito rispetto a quello calcolato dal contenuto. Se i due hash non corrispondono, l'operazione non riesce e restituisce il codice di errore 400 (richiesta non valida).
azure_storage.blob_get
Funzione che importa i dati scaricando un file da un contenitore BLOB in un account Archiviazione di Azure. Converte il contenuto in righe, che è possibile utilizzare ed elaborare usando costrutti di linguaggio SQL. Questa funzione aggiunge il supporto per filtrare e modificare i dati recuperati dal contenitore BLOB prima di importarli.
Annotazioni
Prima di tentare di accedere al contenitore per l'account di archiviazione di riferimento, questa funzione controlla se i nomi dell'account di archiviazione e del contenitore passati come argomenti sono validi in base alle regole di convalida dei nomi imposte agli account di archiviazione Azure. Se uno dei due nomi non è valido, la funzione restituisce un errore.
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);
Una versione di overload di questa funzione accetta un rec parametro che è possibile usare per definire facilmente il record di formato di output.
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);
Permissions
Aggiungere l'utente o il ruolo che richiama questa funzione all'elenco elementi consentiti per account_name eseguendo azure_storage.account_user_add. I membri di azure_storage_admin sono autorizzati automaticamente a fare riferimento a tutti gli account Archiviazione di Azure i cui riferimenti sono stati aggiunti tramite azure_storage.account_add.
Arguments
account_name
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
nome_del_contenitore
text nome di un contenitore. Un contenitore organizza un set di BLOB, simile a una directory in un file system. Un account di archiviazione può includere un numero illimitato di contenitori e un contenitore può archiviare un numero illimitato di BLOB.
Un nome contenitore deve essere un nome DNS (Domain Name System) valido, perché fa parte dell'URI univoco usato per indirizzare il contenitore o i relativi BLOB.
Quando si assegna un nome a un contenitore, seguire queste regole.
L'URI per un contenitore è simile al seguente: https://myaccount.blob.core.windows.net/mycontainer
path
text nome completo del BLOB.
Rec
anyelement definizione della struttura di output del record.
decodificatore
text specifica del formato BLOB. Impostare su uno dei valori seguenti:
| Formato | Predefinita | Descrizione |
|---|---|---|
auto |
true |
Deduce il valore in base all'ultima serie di caratteri assegnati al nome del BLOB. Se il nome del BLOB termina con .parquet, presuppone parquet. Se termina con .csv o .csv.gz, presuppone csv. Se termina con .tsv o .tsv.gz, presuppone tsv. Se termina con .json, .json.gz.xml, .xml.gz, .txt, o .txt.gz, presuppone text. |
binary |
Formato di copia di PostgreSQL binario. | |
csv |
Formato di valori delimitati da virgole usato da PostgreSQL COPY. | |
parquet |
Formato Parquet. | |
text | xml | json |
File contenente un singolo valore di testo. | |
tsv |
Valori delimitati da tabulazioni, il formato predefinito di PostgreSQL COPY. |
compression
text specifica del tipo di compressione. Impostare su uno dei valori seguenti:
| Formato | Predefinita | Descrizione |
|---|---|---|
auto |
true |
Deduce il valore in base all'ultima serie di caratteri assegnati al nome del BLOB. Se il nome del BLOB termina con .gz, presuppone gzip. In caso contrario, presuppone none. |
brotli |
Usa l'algoritmo di compressione brotli per comprimere il BLOB. Supportato solo dal parquet codificatore. |
|
gzip |
Forza l'uso dell'algoritmo di compressione gzip per comprimere il BLOB. | |
lz4 |
Usa l'algoritmo di compressione lz4 per comprimere il BLOB. Il parquet codificatore è l'unico codificatore che supporta questo algoritmo. |
|
none |
Non comprime il BLOB. | |
snappy |
Usa l'algoritmo di compressione snappy per comprimere il BLOB. Il parquet codificatore è l'unico codificatore che supporta questo algoritmo. |
|
zstd |
Usa l'algoritmo di compressione zstd per comprimere il BLOB. Il parquet codificatore è l'unico codificatore che supporta questo algoritmo. |
L'estensione non supporta altri tipi di compressione.
options
jsonb impostazioni che definiscono la gestione di intestazioni personalizzate, separatori personalizzati, caratteri di escape e altre opzioni.
options influisce sul comportamento di questa funzione in modo simile al modo in cui le opzioni che è possibile passare al COPY comando in PostgreSQL ne influiscono sul comportamento.
Tipo di ritorno
SETOF record
SETOF anyelement
azure_storage.blob_put
Funzione che esporta i dati caricando file in un contenitore BLOB in un account Archiviazione di Azure. La funzione crea il contenuto del file dalle righe in PostgreSQL.
Annotazioni
Prima di tentare di accedere al contenitore per l'account di archiviazione di riferimento, questa funzione controlla se i nomi dell'account di archiviazione e del contenitore passati come argomenti sono validi in base alle regole di convalida dei nomi imposte agli account di archiviazione Azure. Se uno dei due nomi non è valido, la funzione restituisce un errore.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
Una versione di overload della funzione include il encoder parametro . Usare questo parametro per specificare il codificatore quando non può essere dedotto dall'estensione del path parametro o quando si vuole eseguire l'override del codificatore dedotto.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
Una versione di overload della funzione include il compression parametro . Usare questo parametro per specificare la compressione quando non può essere dedotto dall'estensione del path parametro o quando si desidera eseguire l'override della compressione dedotta.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Una versione di overload della funzione include il options parametro per la gestione di intestazioni personalizzate, separatori personalizzati, caratteri di escape e altre opzioni. Il options parametro funziona in modo simile alle opzioni che è possibile passare al COPY comando in PostgreSQL.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;
Permissions
Aggiungere l'utente o il ruolo che richiama questa funzione all'elenco elementi consentiti per account_name eseguendo azure_storage.account_user_add. I membri di azure_storage_admin sono autorizzati automaticamente a fare riferimento a tutti gli account Archiviazione di Azure i cui riferimenti sono stati aggiunti tramite azure_storage.account_add.
Arguments
account_name
text nome dell'account di archiviazione BLOB di Azure che contiene tutti gli oggetti: BLOB, file, code e tabelle. L'account di archiviazione fornisce uno spazio dei nomi univoco a cui è possibile accedere da qualsiasi posizione del mondo tramite HTTPS.
nome_del_contenitore
text nome di un contenitore. Un contenitore organizza un set di BLOB, simile a una directory in un file system. Un account di archiviazione può includere un numero illimitato di contenitori e un contenitore può archiviare un numero illimitato di BLOB.
Un nome contenitore deve essere un nome DNS (Domain Name System) valido, perché fa parte dell'URI univoco usato per indirizzare il contenitore o i relativi BLOB.
Quando si assegna un nome a un contenitore, seguire queste regole.
L'URI per un contenitore è simile al seguente: https://myaccount.blob.core.windows.net/mycontainer
path
text nome completo del BLOB.
tupla
record definizione della struttura di output del record.
codificatore
text specifica del formato BLOB. Impostare su uno dei valori seguenti:
| Formato | Predefinita | Descrizione |
|---|---|---|
auto |
true |
Deduce il valore in base all'ultima serie di caratteri assegnati al nome del BLOB. Se il nome del BLOB termina con .csv o .csv.gz, presuppone csv. Se termina con .tsv o .tsv.gz, presuppone tsv. Se termina con , .json.gz, , , o .txt.gz, presuppone text. .txt.xml.gz.xml.json |
binary |
Formato di copia di PostgreSQL binario. | |
csv |
Formato di valori delimitati da virgole usato da PostgreSQL COPY. | |
parquet |
Formato Parquet. | |
text | xml | json |
File contenente un singolo valore di testo. | |
tsv |
Valori delimitati da tabulazioni, il formato predefinito di PostgreSQL COPY. |
compression
text specifica del tipo di compressione. Impostare su uno dei valori seguenti:
| Formato | Predefinita | Descrizione |
|---|---|---|
auto |
true |
Deduce il valore in base all'ultima serie di caratteri assegnati al nome del BLOB. Se il nome del BLOB termina con .gz, presuppone gzip. In caso contrario, presuppone none. |
brotli |
Usa l'algoritmo di compressione brotli per comprimere il BLOB. Supportato solo dal parquet codificatore. |
|
gzip |
Forza l'uso dell'algoritmo di compressione gzip per comprimere il BLOB. | |
lz4 |
Usa l'algoritmo di compressione lz4 per comprimere il BLOB. Il parquet codificatore è l'unico codificatore che supporta questo algoritmo. |
|
none |
Non comprime il BLOB. | |
snappy |
Usa l'algoritmo di compressione snappy per comprimere il BLOB. Il parquet codificatore è l'unico codificatore che supporta questo algoritmo. |
|
zstd |
Usa l'algoritmo di compressione zstd per comprimere il BLOB. Il parquet codificatore è l'unico codificatore che supporta questo algoritmo. |
L'estensione non supporta altri tipi di compressione.
options
jsonb impostazioni che definiscono la gestione di intestazioni personalizzate, separatori personalizzati, caratteri di escape e altre opzioni.
options influisce sul comportamento di questa funzione in modo simile al modo in cui le opzioni che è possibile passare al COPY comando in PostgreSQL ne influiscono sul comportamento.
Tipo di ritorno
VOID
azure_storage.options_copy
Funzione di utilità che è possibile chiamare come parametro all'interno blob_getdi . Funge da funzione helper per 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);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
delimitatore
text Carattere che separa le colonne all'interno di ogni riga (riga) del file. Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY delimiter must be a single one-byte character errore.
null_string
text Stringa che rappresenta un valore Null. Il valore predefinito è \N (barra rovesciata-N) in formato testo e una stringa vuota senza virgolette in formato CSV. È possibile preferire una stringa vuota anche in formato testo per i casi in cui non si vogliono distinguere i valori Null dalle stringhe vuote.
intestazione
boolean Flag che indica se il file contiene una riga di intestazione con i nomi di ogni colonna nel file. Nell'output la riga iniziale contiene i nomi delle colonne della tabella.
offerta
text Carattere di virgolette da utilizzare quando viene racchiuso tra virgolette un valore di dati. Il valore predefinito è virgolette doppie. Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY quote must be a single one-byte character errore.
fuga
text Carattere che deve essere visualizzato prima di un carattere di dati corrispondente al valore quote. Il valore predefinito è uguale al valore quote (in modo che il carattere tra virgolette venga raddoppiato se viene visualizzato nei dati). Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY escape must be a single one-byte character errore.
force_quote
text[] forza l'uso delle virgolette per tutti i valori non NULL in ogni colonna specificata. L'output NULL non è mai racchiuso tra virgolette. Se * è specificato, i valori non NULL vengono racchiusi tra virgolette in tutte le colonne.
force_not_null
text[] Non associare i valori delle colonne specificate alla stringa Null. Nel caso predefinito in cui la stringa Null è vuota, significa che i valori vuoti vengono letti come stringhe di lunghezza zero anziché null, anche quando non sono racchiusi tra virgolette.
force_null
text[] Trova la corrispondenza con i valori delle colonne specificate rispetto alla stringa Null, anche se racchiusa tra virgolette. Se viene trovata una corrispondenza, impostare il valore su NULL. Nel caso predefinito in cui la stringa Null è vuota, converte una stringa vuota tra virgolette in NULL.
content_encoding
text Nome della codifica con cui viene codificato il file. Se si omette questa opzione, viene usata la codifica client corrente.
Tipo di ritorno
jsonb
azure_storage.options_parquet
Funzione di utilità per decodificare il contenuto di un file Parquet. Usarlo come parametro in blob_get.
azure_storage.options_parquet();
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
Tipo di ritorno
jsonb
azure_storage.options_csv_get
Funzione di utilità per decodificare il contenuto di un file CSV. Chiamare questa funzione come parametro all'interno di blob_get.
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);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
delimitatore
text Carattere che separa le colonne all'interno di ogni riga (riga) del file. Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY delimiter must be a single one-byte character errore.
null_string
text Stringa che rappresenta un valore Null. Il valore predefinito è \N (barra rovesciata-N) in formato testo e una stringa vuota senza virgolette in formato CSV. È possibile preferire una stringa vuota anche in formato testo per i casi in cui non si vogliono distinguere i valori Null dalle stringhe vuote.
intestazione
boolean Flag che indica se il file contiene una riga di intestazione con i nomi di ogni colonna nel file. Nell'output la riga iniziale contiene i nomi delle colonne della tabella.
offerta
text Carattere di virgolette da utilizzare quando viene racchiuso tra virgolette un valore di dati. Il valore predefinito è virgolette doppie. Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY quote must be a single one-byte character errore.
fuga
text Carattere che deve essere visualizzato prima di un carattere di dati corrispondente al valore quote. Il valore predefinito è uguale al valore quote (in modo che il carattere tra virgolette venga raddoppiato se viene visualizzato nei dati). Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY escape must be a single one-byte character errore.
force_not_null
text[] Non associare i valori delle colonne specificate alla stringa Null. Nel caso predefinito in cui la stringa Null è vuota, significa che i valori vuoti vengono letti come stringhe di lunghezza zero anziché null, anche quando non sono racchiusi tra virgolette.
force_null
text[] Trova la corrispondenza con i valori delle colonne specificate rispetto alla stringa Null, anche se racchiusa tra virgolette. Se viene trovata una corrispondenza, impostare il valore su NULL. Nel caso predefinito in cui la stringa Null è vuota, converte una stringa vuota tra virgolette in NULL.
content_encoding
text Nome della codifica con cui viene codificato il file. Se si omette questa opzione, viene usata la codifica client corrente.
Tipo di ritorno
jsonb
azure_storage.options_tsv
Funzione di utilità per decodificare il contenuto di un file TSV. Chiamare questa funzione come parametro all'interno di blob_get.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
delimitatore
text Carattere che separa le colonne all'interno di ogni riga (riga) del file. Deve essere un singolo carattere a 1 byte. Anche se questa funzione supporta delimitatori di un numero qualsiasi di caratteri, se si tenta di usare più di un singolo carattere a 1 byte, PostgreSQL restituisce un COPY delimiter must be a single one-byte character errore.
null_string
text Stringa che rappresenta un valore Null. Il valore predefinito è \N (barra rovesciata-N) in formato testo e una stringa vuota senza virgolette in formato CSV. È possibile preferire una stringa vuota anche in formato testo per i casi in cui non si vogliono distinguere i valori Null dalle stringhe vuote.
content_encoding
text Nome della codifica con cui viene codificato il file. Se si omette questa opzione, viene usata la codifica client corrente.
Tipo di ritorno
jsonb
azure_storage.options_binary
Funzione di utilità che è possibile chiamare come parametro all'interno blob_getdi . Consente di decodificare il contenuto di un file binario.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Permissions
Qualsiasi utente o ruolo può richiamare questa funzione.
Arguments
content_encoding
text Nome della codifica con cui viene codificato il file. Se si omette questa opzione, viene usata la codifica client corrente.
Tipo di ritorno
jsonb