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.
Di seguito è riportato l'elenco delle funzioni fornite dall'estensione Archiviazione di Azure:
azure_storage.account_add
Funzione che consente di aggiungere 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);
È disponibile una versione di overload di questa funzione, che 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);
Autorizzazioni
Deve essere un membro di azure_storage_admin.
Argomenti
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 accessibile da qualsiasi parte 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 accessibile solo dall'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. È consigliabile 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 devono essere passati come argomento.
Tipo di ritorno
VOID
azure_storage.account_options_managed_identity
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno di azure_storage.account_add ed è utile per produrre un valore valido per l'argomento, quando si usa un'identità account_config gestita assegnata dal sistema per interagire con l'account di archiviazione di Azure.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
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 accessibile da qualsiasi parte del mondo tramite HTTPS.
tipo
azure_storage.storage_type valore di uno dei tipi di archiviazione supportati. Solo il valore supportato è blob.
Tipo di ritorno
jsonb
azure_storage.account_options_credentials
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno di azure_storage.account_add ed è utile per produrre un valore valido per l'argomento account_config , quando si usa una chiave di accesso di Archiviazione di Azure per interagire con l'account di archiviazione di Azure.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
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 accessibile da qualsiasi parte del mondo tramite HTTPS.
credenziali
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 accessibile solo dall'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
azure_storage.storage_type valore di uno dei tipi di archiviazione supportati. Solo il valore supportato è blob.
Tipo di ritorno
jsonb
azure_storage.account_options
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno di azure_storage.account_add ed è utile per produrre un valore valido per l'argomento account_config , quando si usa una chiave di accesso di Archiviazione di Azure o un'identità gestita assegnata dal sistema per interagire con l'account di 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);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
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 accessibile da qualsiasi parte del mondo tramite HTTPS.
auth_type
azure_storage.auth_type valore di uno dei tipi di archiviazione supportati. Solo i valori supportati sono access-keye managed-identity.
storage_type
azure_storage.storage_type valore di uno dei tipi di archiviazione supportati. Solo il valore supportato è blob.
credenziali
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 accessibile solo dall'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 consente di rimuovere 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);
Autorizzazioni
Deve essere un membro di azure_storage_admin.
Argomenti
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 accessibile da qualsiasi parte del mondo tramite HTTPS.
Tipo di ritorno
VOID
azure_storage.account_user_add
Funzione che consente di concedere 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 viene 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);
Autorizzazioni
Deve essere un membro di azure_storage_admin.
Argomenti
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 accessibile da qualsiasi parte 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 consente di revocare un utente o un ruolo PostgreSQL all'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 viene 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 ancora.
Quando un utente o un ruolo viene eliminato dal server, eseguendo DROP USER | ROLE, le autorizzazioni concesse per qualsiasi riferimento agli account di archiviazione di Azure vengono eliminate automaticamente.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Autorizzazioni
Deve essere un membro di azure_storage_admin.
Argomenti
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 accessibile da qualsiasi parte 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 a cui sono concesse le autorizzazioni per interagire con tale account di archiviazione tramite le funzioni fornite dall'estensione azure_storage .
azure_storage.account_list();
Autorizzazioni
Deve essere un membro di azure_storage_admin.
Argomenti
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 di 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 a cui è concesso l'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);
Autorizzazioni
L'utente o il ruolo che richiama questa funzione deve essere aggiunto all'elenco consentito per l'oggetto account_name a cui viene fatto riferimento eseguendo azure_storage.account_user_add. I membri di sono autorizzati automaticamente a fare riferimento a tutti gli account di archiviazione di azure_storage_admin Azure i cui riferimenti sono stati aggiunti usando azure_storage.account_add.
Argomenti
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 accessibile da qualsiasi parte 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, assicurarsi di seguire queste regole.
L'URI per un contenitore è simile al seguente: https://myaccount.blob.core.windows.net/mycontainer
prefisso
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à.
sentiero
text nome completo del BLOB.
Byte
bigint dimensioni del BLOB in byte.
last_modified
timestamp with time zonedata 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 con un hash calcolato dal contenuto. Se i due hash non corrispondono, l'operazione ha esito negativo con il codice di errore 400 (richiesta non valida).
azure_storage.blob_get
Funzione che consente l'importazione di dati. Scarica un file da un contenitore BLOB in un account di archiviazione di Azure. Converte quindi il contenuto in righe, che possono essere utilizzate ed elaborate con 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 di Azure. Se uno di essi non è valido, viene generato 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);
È disponibile una versione di overload di questa funzione, che accetta un rec parametro che consente di 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);
Autorizzazioni
L'utente o il ruolo che richiama questa funzione deve essere aggiunto all'elenco consentito per l'oggetto account_name a cui viene fatto riferimento eseguendo azure_storage.account_user_add. I membri di sono autorizzati automaticamente a fare riferimento a tutti gli account di archiviazione di azure_storage_admin Azure i cui riferimenti sono stati aggiunti usando azure_storage.account_add.
Argomenti
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 accessibile da qualsiasi parte 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, assicurarsi di seguire queste regole.
L'URI per un contenitore è simile al seguente: https://myaccount.blob.core.windows.net/mycontainer
sentiero
text nome completo del BLOB.
Rec
anyelement definizione della struttura di output del record.
decodificatore
text specifica del formato BLOB. Può essere impostato 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. |
compressione
text specifica del tipo di compressione. Può essere impostato 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 |
Forza l'uso dell'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 |
Forza l'uso dell'algoritmo di compressione lz4 per comprimere il BLOB. Supportato solo dal parquet codificatore. |
|
none |
Forza a non comprimere il BLOB. | |
snappy |
Forza l'uso dell'algoritmo di compressione snappy per comprimere il BLOB. Supportato solo dal parquet codificatore. |
|
zstd |
Forza l'uso dell'algoritmo di compressione zstd per comprimere il BLOB. Supportato solo dal parquet codificatore. |
L'estensione non supporta altri tipi di compressione.
Opzioni
jsonb impostazioni che definiscono la gestione di intestazioni personalizzate, separatori personalizzati, caratteri di escape e così via. 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 consente di esportare i dati caricando i file in un contenitore BLOB in un account di archiviazione di Azure. Il contenuto dei file viene generato 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 di Azure. Se uno di essi non è valido, viene generato un errore.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
È disponibile una versione di overload della funzione contenente encoder il parametro che consente di specificare il codificatore da usare quando non può essere dedotto dall'estensione del path parametro o quando si vuole eseguire l'override di quello dedotto.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
È disponibile una versione di overload della funzione che contiene anche un compression parametro che consente di specificare la compressione da usare quando non può essere dedotto dall'estensione del path parametro o quando si vuole eseguire l'override di quello dedotto.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Esiste una versione di overload della funzione che contiene anche un options parametro per la gestione di intestazioni personalizzate, separatori personalizzati, caratteri di escape e così via. options Funziona in modo analogo alle opzioni che possono essere passate 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;
Autorizzazioni
L'utente o il ruolo che richiama questa funzione deve essere aggiunto all'elenco consentito per l'oggetto account_name a cui viene fatto riferimento eseguendo azure_storage.account_user_add. I membri di sono autorizzati automaticamente a fare riferimento a tutti gli account di archiviazione di azure_storage_admin Azure i cui riferimenti sono stati aggiunti usando azure_storage.account_add.
Argomenti
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 accessibile da qualsiasi parte 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, assicurarsi di seguire queste regole.
L'URI per un contenitore è simile al seguente: https://myaccount.blob.core.windows.net/mycontainer
sentiero
text nome completo del BLOB.
tupla
record definizione della struttura di output del record.
codificatore
text specifica del formato BLOB. Può essere impostato 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, .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. |
compressione
text specifica del tipo di compressione. Può essere impostato 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 |
Forza l'uso dell'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 |
Forza l'uso dell'algoritmo di compressione lz4 per comprimere il BLOB. Supportato solo dal parquet codificatore. |
|
none |
Forza a non comprimere il BLOB. | |
snappy |
Forza l'uso dell'algoritmo di compressione snappy per comprimere il BLOB. Supportato solo dal parquet codificatore. |
|
zstd |
Forza l'uso dell'algoritmo di compressione zstd per comprimere il BLOB. Supportato solo dal parquet codificatore. |
L'estensione non supporta altri tipi di compressione.
Opzioni
jsonb impostazioni che definiscono la gestione di intestazioni personalizzate, separatori personalizzati, caratteri di escape e così via. 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 che funge da funzione di utilità, che può essere chiamata 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);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
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 corrispondono ai valori delle colonne specificate rispetto 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[] associare i valori delle colonne specificate alla stringa Null, anche se tra virgolette e, 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 l'opzione viene omessa, viene usata la codifica client corrente.
Tipo di ritorno
jsonb
azure_storage.options_parquet
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno blob_getdi ed è utile per decodificare il contenuto di un file Parquet.
azure_storage.options_parquet();
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
Tipo di ritorno
jsonb
azure_storage.options_csv_get
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno blob_getdi ed è utile per decodificare il contenuto di un file 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);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
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 corrispondono ai valori delle colonne specificate rispetto 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[] associare i valori delle colonne specificate alla stringa Null, anche se tra virgolette e, 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 l'opzione viene omessa, viene usata la codifica client corrente.
Tipo di ritorno
jsonb
azure_storage.options_tsv
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno blob_getdi ed è utile per decodificare il contenuto di un file tsv.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
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 l'opzione viene omessa, viene usata la codifica client corrente.
Tipo di ritorno
jsonb
azure_storage.options_binary
Funzione che funge da funzione di utilità, che può essere chiamata come parametro all'interno blob_getdi ed è utile per decodificare il contenuto di un file binario.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Autorizzazioni
Qualsiasi utente o ruolo può richiamare questa funzione.
Argomenti
content_encoding
text nome della codifica con cui viene codificato il file. Se l'opzione viene omessa, viene usata la codifica client corrente.
Tipo di ritorno
jsonb