Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
In de volgende lijst ziet u de functies van de Azure Storage-extensie:
azure_storage.account_add
Functie waarmee een opslagaccount en de bijbehorende toegangssleutel worden toegevoegd aan de lijst met opslagaccounts waartoe de azure_storage extensie toegang heeft.
Als een eerdere aanroep van deze functie al de verwijzing naar dit opslagaccount heeft toegevoegd, wordt er geen nieuwe vermelding toegevoegd, maar wordt in plaats daarvan de toegangssleutel van de bestaande vermelding bijgewerkt.
Opmerking
Met deze functie wordt niet gevalideerd of de naam van het bedoelde account bestaat of als deze toegankelijk is met de opgegeven toegangssleutel. Er wordt echter gevalideerd dat de naam van het opslagaccount geldig is, volgens de naamgevingsvalidatieregels die zijn opgelegd aan Azure-opslagaccounts.
azure_storage.account_add(account_name_p text, account_key_p text);
Een overbelaste versie van deze functie accepteert een account_config parameter waarmee de naam van het Azure Storage-account waarnaar wordt verwezen, wordt ingekapseld en alle vereiste instellingen, zoals verificatietype, accounttype of opslagreferenties.
azure_storage.account_add(account_config jsonb);
Permissions
Moet lid zijn van azure_storage_admin.
Arguments
account_name_p
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
account_key_p
text de waarde van een van de toegangssleutels voor het opslagaccount. Uw toegangssleutels voor Azure Blob Storage zijn vergelijkbaar met een hoofdwachtwoord voor uw opslagaccount. Wees altijd voorzichtig met het beveiligen van uw toegangssleutels. Gebruik Azure Key Vault om uw sleutels veilig te beheren en te roteren. De accountsleutel wordt opgeslagen in een tabel waartoe alleen de supergebruiker toegang heeft. Gebruikers die de azure_storage_admin rol hebben verleend, kunnen met deze tabel communiceren via functies. Als u wilt zien welke opslagaccounts worden toegevoegd, gebruikt u de functie azure_storage.account_list.
account_config
jsonb de naam van het Azure Storage-account en alle vereiste instellingen, zoals verificatietype, accounttype of opslagreferenties. Gebruik de hulpprogrammafuncties azure_storage.account_options_managed_identity, azure_storage.account_options_credentials of azure_storage.account_options om een van de geldige waarden te maken die u als dit argument moet doorgeven.
Resultaattype
VOID
azure_storage.account_encrypt_existing_credentials
Functie waarmee een lijst wordt gescand met bestaande opslagaccounts die u hebt toegevoegd met behulp van azure_storage.account_add in oudere versies van de extensie. In deze versies worden niet-versleutelde referenties opgeslagen. Met deze functie worden alle referenties versleuteld met behulp van de sleutel die is opgeslagen in azure_storage.credential_encryption_key. De waarde van azure_storage.credential_encryption_key het bereik is bereikt op serverniveau. Als u daarom de Azure Storage-extensie maakt in meerdere databases op dezelfde server, versleutelt dezelfde versleutelingssleutel alle gevoelige referenties die zijn opgeslagen door de extensie, ongeacht de database waarin ze zijn opgeslagen.
Belangrijk
Als u de Azure Storage-extensie in meerdere databases van dezelfde server maakt, moet u de azure_storage.account_encrypt_existing_credentials functie in elk van deze databases uitvoeren.
azure_storage.account_encrypt_existing_credentials();
Permissions
Moet lid zijn van azure_storage_admin.
Arguments
Deze functie heeft geen argumenten.
Resultaattype
bigint Het aantal bestaande opslagaccountreferenties die niet zijn versleuteld voordat de functie werd uitgevoerd en nu worden versleuteld met behulp van de sleutel die is opgeslagen in azure_storage.credential_encryption_key.
azure_storage.account_options_managed_identity
Functie die fungeert als een hulpprogrammafunctie. Roep deze aan als een parameter in azure_storage.account_add. Hiermee kunt u een geldige waarde voor het argument maken wanneer u een door het account_config systeem toegewezen beheerde identiteit gebruikt om te communiceren met het Azure Storage-account.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
Permissions
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
naam
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
type
azure_storage.storage_type de waarde van een van de ondersteunde typen opslag. Ondersteunde waarde is blob.
Resultaattype
jsonb
azure_storage.account_options_credentials
Hulpprogrammafunctie die u kunt aanroepen als een parameter binnen azure_storage.account_add. Hiermee kunt u een geldige waarde voor het account_config argument maken wanneer u een Azure Storage toegangssleutel gebruikt om te communiceren met het Azure Storage-account.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
Permissions
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
naam
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
credentials
text de waarde van een van de toegangssleutels voor het opslagaccount. Uw toegangssleutels voor Azure Blob Storage zijn vergelijkbaar met een hoofdwachtwoord voor uw opslagaccount. Wees altijd voorzichtig met het beveiligen van uw toegangssleutels. Gebruik Azure Key Vault om uw sleutels veilig te beheren en te roteren. De accountsleutel wordt opgeslagen in een tabel waartoe alleen de supergebruiker toegang heeft. Gebruikers die de azure_storage_admin rol hebben verleend, kunnen met deze tabel communiceren via functies. Als u wilt zien welke opslagaccounts worden toegevoegd, gebruikt u de functie azure_storage.account_list.
type
azure_storage.storage_type de waarde van een van de ondersteunde typen opslag. Ondersteunde waarde is blob.
Resultaattype
jsonb
azure_storage.account_options
Hulpprogrammafunctie die u kunt aanroepen als een parameter binnen azure_storage.account_add. Hiermee kunt u een geldige waarde voor het account_config argument maken wanneer u een Azure Storage toegangssleutel of een door het systeem toegewezen beheerde identiteit gebruikt om te communiceren met het Azure Storage-account.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
Permissions
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
naam
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
auth_type
azure_storage.auth_type de waarde van een van de ondersteunde typen opslag. Ondersteunde waarden zijn access-key en managed-identity.
storage_type
azure_storage.storage_type de waarde van een van de ondersteunde typen opslag. Ondersteunde waarde is blob.
credentials
text de waarde van een van de toegangssleutels voor het opslagaccount. Uw toegangssleutels voor Azure Blob Storage zijn vergelijkbaar met een hoofdwachtwoord voor uw opslagaccount. Wees altijd voorzichtig met het beveiligen van uw toegangssleutels. Gebruik Azure Key Vault om uw sleutels veilig te beheren en te roteren. De accountsleutel wordt opgeslagen in een tabel waartoe alleen de supergebruiker toegang heeft. Gebruikers die de azure_storage_admin rol hebben verleend, kunnen met deze tabel communiceren via functies. Als u wilt zien welke opslagaccounts worden toegevoegd, gebruikt u de functie azure_storage.account_list.
Resultaattype
jsonb
azure_storage.account_remove
Functie die een opslagaccount en de bijbehorende toegangssleutel verwijdert uit de lijst met opslagaccounts waartoe de azure_storage extensie toegang heeft.
azure_storage.account_remove(account_name_p text);
Permissions
Moet lid zijn van azure_storage_admin.
Arguments
account_name_p
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
Resultaattype
VOID
azure_storage.account_user_add
Functie die een PostgreSQL-gebruiker of -rol toegang verleent tot een opslagaccount via de functies van de azure_storage extensie.
Opmerking
De uitvoering van deze functie slaagt alleen als het opslagaccount, waarvan u de naam als het eerste argument doorgeeft, al is gemaakt met behulp van azure_storage.account_add, en als de gebruiker of rol, waarvan u de naam als het tweede argument doorgeeft, al bestaat.
azure_storage.account_add(account_name_p text, user_p regrole);
Permissions
Moet lid zijn van azure_storage_admin.
Arguments
account_name_p
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
user_p
regrole de naam van een PostgreSQL-gebruiker of -rol die beschikbaar is op de server.
Resultaattype
VOID
azure_storage.account_user_remove
Functie waarmee een PostgreSQL-gebruiker of -roltoegang tot een opslagaccount wordt ingetrokken via de functies van de azure_storage extensie.
Opmerking
De uitvoering van deze functie slaagt alleen als het opslagaccount waarvan u de naam doorgeeft als het eerste argument al bestaat en is gemaakt met behulp van azure_storage.account_add. De gebruiker of rol waarvan u de naam als tweede argument doorgeeft, moet ook bestaan.
Wanneer u een gebruiker of rol van de server neer zet door deze uit te DROP USER | ROLEvoeren, worden de machtigingen die zijn verleend aan een verwijzing naar Azure Storage accounts ook automatisch verwijderd.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Permissions
Moet lid zijn van azure_storage_admin.
Arguments
account_name_p
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
user_p
regrole de naam van een PostgreSQL-gebruiker of -rol die beschikbaar is op de server.
Resultaattype
VOID
azure_storage.account_list
Functie met de namen van de opslagaccounts die u hebt geconfigureerd via de functie azure_storage.account_add , samen met de PostgreSQL-gebruikers of -rollen die gemachtigd zijn om met dat opslagaccount te communiceren via de functies van de azure_storage extensie.
azure_storage.account_list();
Permissions
Moet lid zijn van azure_storage_admin.
Arguments
Deze functie heeft geen argumenten.
Resultaattype
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[])een tabel met vier kolommen met de lijst met Azure Storage accounts toegevoegd, het type verificatie dat wordt gebruikt voor interactie met elk account, het type opslag en de lijst met PostgreSQL-gebruikers of -rollen die toegang hebben tot het account.
azure_storage.blob_list
Functie met de namen en andere eigenschappen (grootte, lastModified, eTag, contentType, contentEncoding en contentHash) van blobs die zijn opgeslagen in de opgegeven container van het bedoelde opslagaccount.
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
Permissions
Voeg de gebruiker of rol die deze functie aanroept toe aan de acceptatielijst voor de account_name functie door azure_storage.account_user_add uit te voeren. Leden van azure_storage_admin de groep mogen automatisch verwijzen naar alle Azure Storage accounts waarvan de verwijzingen zijn toegevoegd met behulp van azure_storage.account_add.
Arguments
account_name
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
containernaam
text de naam van een container. Een container kan een of meer blobs bevatten, net zoals een map een of meer bestanden kan bevatten in een bestandssysteem. Een opslagaccount kan een onbeperkt aantal containers bevatten en een container kan een onbeperkt aantal blobs bevatten.
Een containernaam moet een geldige DNS-naam (Domain Name System) zijn, omdat deze deel uitmaakt van de unieke URI die wordt gebruikt om de container of de bijbehorende blobs te adresseren.
Volg deze regels bij het benoemen van een container.
De URI voor een container is vergelijkbaar met: https://myaccount.blob.core.windows.net/mycontainer
prefix
text indien opgegeven, retourneert de functie de blobs waarvan de namen beginnen met de waarde die in deze parameter is opgegeven. Standaard ingesteld op een lege tekenreeks.
Resultaattype
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) een tabel met één record per blob geretourneerd, inclusief de volledige naam van de blob en enkele andere eigenschappen.
path
text de volledige naam van de blob.
bytes
bigint de grootte van de blob in bytes.
last_modified
timestamp with time zone de datum en tijd waarop de blob het laatst is gewijzigd. Elke bewerking die de blob wijzigt, inclusief een update van de metagegevens of eigenschappen van de blob, wijzigt de laatste wijzigingstijd van de blob.
etag
text de eigenschap ETag wordt gebruikt voor optimistische gelijktijdigheid tijdens updates. Het is geen tijdstempel omdat er een andere eigenschap is met de naam Timestamp waarin de laatste keer dat een record is bijgewerkt, wordt opgeslagen. Als u bijvoorbeeld een entiteit laadt en deze wilt bijwerken, moet de ETag overeenkomen met wat momenteel is opgeslagen. Het instellen van de juiste ETag is belangrijk omdat als u meerdere gebruikers hetzelfde item bewerkt, u niet wilt dat ze elkaars wijzigingen overschrijven.
content_type
text het inhoudstype dat is opgegeven voor de blob. Het standaardinhoudstype is application/octet-stream.
content_encoding
text de eigenschap Content-Encoding van een blob die u met Azure Storage kunt definiëren. Voor gecomprimeerde inhoud kunt u de eigenschap instellen op Gzip. Wanneer de browser toegang heeft tot de inhoud, wordt de inhoud automatisch gedecomprimeert.
content_hash
text de hash die wordt gebruikt om de integriteit van de blob tijdens het transport te controleren. Wanneer u deze header opgeeft, controleert de opslagservice de opgegeven hash op basis van de hash die wordt berekend op basis van de inhoud. Als de twee hashes niet overeenkomen, mislukt de bewerking en retourneert de foutcode 400 (Ongeldige aanvraag).
azure_storage.blob_get
Functie waarmee gegevens worden geïmporteerd door een bestand te downloaden uit een blobcontainer in een Azure Storage-account. De inhoud wordt omgezet in rijen, die u kunt gebruiken en verwerken met behulp van SQL-taalconstructies. Met deze functie wordt ondersteuning toegevoegd voor het filteren en bewerken van de gegevens die zijn opgehaald uit de blobcontainer voordat u deze importeert.
Opmerking
Voordat u toegang probeert te krijgen tot de container voor het bedoelde opslagaccount, controleert deze functie of de namen van het opslagaccount en de container die u als argumenten doorgeeft, geldig zijn volgens de naamgevingsregels die zijn opgelegd aan Azure opslagaccounts. Als een van beide namen ongeldig is, retourneert de functie een fout.
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);
Een overbelaste versie van deze functie accepteert een rec parameter die u kunt gebruiken om de record voor de uitvoerindeling gemakkelijk te definiëren.
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
Voeg de gebruiker of rol die deze functie aanroept toe aan de acceptatielijst voor de account_name functie door azure_storage.account_user_add uit te voeren. Leden van azure_storage_admin de groep mogen automatisch verwijzen naar alle Azure Storage accounts waarvan de verwijzingen zijn toegevoegd met behulp van azure_storage.account_add.
Arguments
account_name
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
containernaam
text de naam van een container. Een container kan een of meer blobs bevatten, net zoals een map een of meer bestanden kan bevatten in een bestandssysteem. Een opslagaccount kan een onbeperkt aantal containers bevatten en een container kan een onbeperkt aantal blobs bevatten.
Een containernaam moet een geldige DNS-naam (Domain Name System) zijn, omdat deze deel uitmaakt van de unieke URI die wordt gebruikt om de container of de bijbehorende blobs te adresseren.
Volg deze regels bij het benoemen van een container.
De URI voor een container is vergelijkbaar met: https://myaccount.blob.core.windows.net/mycontainer
path
text de volledige naam van de blob.
Rec
anyelement de definitie van de recorduitvoerstructuur.
Decoder
text de specificatie van de blob-indeling. Ingesteld op een van de volgende waarden:
| Formatteren | standaard | Beschrijving |
|---|---|---|
auto |
true |
Hiermee wordt de waarde afgeleid op basis van de laatste reeks tekens die zijn toegewezen aan de naam van de blob. Als de blobnaam eindigt, .parquetwordt ervan uitgegaan parquet. Als het eindigt met .csv of .csv.gz, wordt ervan uitgegaan csv. Als het eindigt met .tsv of .tsv.gz, wordt ervan uitgegaan tsv. Als het eindigt met , , , , .json, of .json.gz.xml, wordt ervan uitgegaan .xml.gz. .txt.txt.gztext |
binary |
Binaire PostgreSQL COPY-indeling. | |
csv |
Door komma's gescheiden waardenindeling die wordt gebruikt door PostgreSQL COPY. | |
parquet |
Parquet-indeling. | |
text | xml | json |
Een bestand met één tekstwaarde. | |
tsv |
Door tabs gescheiden waarden, de standaardIndeling PostgreSQL COPY. |
compression
text de specificatie van het compressietype. Ingesteld op een van de volgende waarden:
| Formatteren | standaard | Beschrijving |
|---|---|---|
auto |
true |
Hiermee wordt de waarde afgeleid op basis van de laatste reeks tekens die zijn toegewezen aan de naam van de blob. Als de blobnaam eindigt, .gzwordt ervan uitgegaan gzip. Anders wordt ervan uitgegaan none. |
brotli |
Maakt gebruik van het brotli-compressie-algoritme om de blob te comprimeren. Alleen ondersteund door parquet encoder. |
|
gzip |
Dwingt het gebruik van gzip-compressiealgoritmen om de blob te comprimeren. | |
lz4 |
Gebruikt het lz4-compressiealgoritme om de blob te comprimeren. De parquet encoder is de enige encoder die dit algoritme ondersteunt. |
|
none |
Comprimeert de blob niet. | |
snappy |
Maakt gebruik van het snappy-compressiealgoritme om de blob te comprimeren. De parquet encoder is de enige encoder die dit algoritme ondersteunt. |
|
zstd |
Gebruikt het zstd-compressie-algoritme om de blob te comprimeren. De parquet encoder is de enige encoder die dit algoritme ondersteunt. |
De extensie biedt geen ondersteuning voor andere compressietypen.
options
jsonb de instellingen voor het afhandelen van aangepaste kopteksten, aangepaste scheidingstekens, escapetekens en andere opties.
options beïnvloedt het gedrag van deze functie op een manier die vergelijkbaar is met de manier waarop de opties die u aan de COPY opdracht in PostgreSQL kunt doorgeven, van invloed zijn op het gedrag ervan.
Resultaattype
SETOF record
SETOF anyelement
azure_storage.blob_put
Functie waarmee gegevens worden geëxporteerd door bestanden te uploaden naar een blobcontainer in een Azure Storage-account. De functie maakt de bestandsinhoud op basis van rijen in PostgreSQL.
Opmerking
Voordat u toegang probeert te krijgen tot de container voor het bedoelde opslagaccount, controleert deze functie of de namen van het opslagaccount en de container die u als argumenten doorgeeft, geldig zijn volgens de naamgevingsregels die zijn opgelegd aan Azure opslagaccounts. Als een van beide namen ongeldig is, retourneert de functie een fout.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
Een overbelaste versie van de functie bevat de encoder parameter. Gebruik deze parameter om de encoder op te geven wanneer deze niet kan worden afgeleid van de extensie van de path parameter of wanneer u de afgeleide encoder wilt overschrijven.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
Een overbelaste versie van de functie bevat de compression parameter. Gebruik deze parameter om de compressie op te geven wanneer deze niet kan worden afgeleid van de extensie van de path parameter of wanneer u de uitgestelde compressie wilt overschrijven.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Een overbelaste versie van de functie bevat de parameter voor het options verwerken van aangepaste headers, aangepaste scheidingstekens, escapetekens en andere opties. De options parameter werkt op dezelfde manier als de opties die u kunt doorgeven aan de COPY opdracht 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
Voeg de gebruiker of rol die deze functie aanroept toe aan de acceptatielijst voor de account_name functie door azure_storage.account_user_add uit te voeren. Leden van azure_storage_admin de groep mogen automatisch verwijzen naar alle Azure Storage accounts waarvan de verwijzingen zijn toegevoegd met behulp van azure_storage.account_add.
Arguments
account_name
text de naam van het Azure Blob Storage-account dat al uw objecten bevat: blobs, bestanden, wachtrijen en tabellen. Het opslagaccount biedt een unieke naamruimte die u overal ter wereld kunt openen via HTTPS.
containernaam
text de naam van een container. Een container kan een of meer blobs bevatten, net zoals een map een of meer bestanden kan bevatten in een bestandssysteem. Een opslagaccount kan een onbeperkt aantal containers bevatten en een container kan een onbeperkt aantal blobs bevatten.
Een containernaam moet een geldige DNS-naam (Domain Name System) zijn, omdat deze deel uitmaakt van de unieke URI die wordt gebruikt om de container of de bijbehorende blobs te adresseren.
Volg deze regels bij het benoemen van een container.
De URI voor een container is vergelijkbaar met: https://myaccount.blob.core.windows.net/mycontainer
path
text de volledige naam van de blob.
Tupel
record de definitie van de recorduitvoerstructuur.
coderingsprogramma
text de specificatie van de blob-indeling. Ingesteld op een van de volgende waarden:
| Formatteren | standaard | Beschrijving |
|---|---|---|
auto |
true |
Hiermee wordt de waarde afgeleid op basis van de laatste reeks tekens die zijn toegewezen aan de naam van de blob. Als de blobnaam eindigt op .csv of .csv.gz, wordt ervan uitgegaan csv. Als het eindigt met .tsv of .tsv.gz, wordt ervan uitgegaan tsv. Als het eindigt met , , , , , of .txt.gz.txt, wordt ervan uitgegaan text. .xml.gz.xml.json.gz.json |
binary |
Binaire PostgreSQL COPY-indeling. | |
csv |
Door komma's gescheiden waardenindeling die wordt gebruikt door PostgreSQL COPY. | |
parquet |
Parquet-indeling. | |
text | xml | json |
Een bestand met één tekstwaarde. | |
tsv |
Door tabs gescheiden waarden, de standaardIndeling PostgreSQL COPY. |
compression
text de specificatie van het compressietype. Ingesteld op een van de volgende waarden:
| Formatteren | standaard | Beschrijving |
|---|---|---|
auto |
true |
Hiermee wordt de waarde afgeleid op basis van de laatste reeks tekens die zijn toegewezen aan de naam van de blob. Als de blobnaam eindigt, .gzwordt ervan uitgegaan gzip. Anders wordt ervan uitgegaan none. |
brotli |
Maakt gebruik van het brotli-compressie-algoritme om de blob te comprimeren. Alleen ondersteund door parquet encoder. |
|
gzip |
Dwingt het gebruik van gzip-compressiealgoritmen om de blob te comprimeren. | |
lz4 |
Gebruikt het lz4-compressiealgoritme om de blob te comprimeren. De parquet encoder is de enige encoder die dit algoritme ondersteunt. |
|
none |
Comprimeert de blob niet. | |
snappy |
Maakt gebruik van het snappy-compressiealgoritme om de blob te comprimeren. De parquet encoder is de enige encoder die dit algoritme ondersteunt. |
|
zstd |
Gebruikt het zstd-compressie-algoritme om de blob te comprimeren. De parquet encoder is de enige encoder die dit algoritme ondersteunt. |
De extensie biedt geen ondersteuning voor andere compressietypen.
options
jsonb de instellingen voor het afhandelen van aangepaste kopteksten, aangepaste scheidingstekens, escapetekens en andere opties.
options beïnvloedt het gedrag van deze functie op een manier die vergelijkbaar is met de manier waarop de opties die u aan de COPY opdracht in PostgreSQL kunt doorgeven, van invloed zijn op het gedrag ervan.
Resultaattype
VOID
azure_storage.options_copy
Hulpprogrammafunctie die u kunt aanroepen als een parameter binnen blob_get. Het fungeert als helperfunctie voor options_parquet, options_csv_get, options_tsv en 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
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
scheidingsteken
text Het teken dat kolommen scheidt binnen elke rij (regel) van het bestand. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY delimiter must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
null_string
text De tekenreeks die een null-waarde vertegenwoordigt. De standaardwaarde is \N (backslash-N) in tekstindeling en een niet-aanhalingstekenloze lege tekenreeks in CSV-indeling. Mogelijk geeft u de voorkeur aan een lege tekenreeks, zelfs in tekstindeling voor gevallen waarin u null-waarden niet wilt onderscheiden van lege tekenreeksen.
koptekst
boolean Vlag die aangeeft of het bestand een koptekstregel bevat met de namen van elke kolom in het bestand. In de uitvoer bevat de eerste regel de kolomnamen uit de tabel.
prijsopgave
text Het aanhalingsteken dat moet worden gebruikt wanneer een gegevenswaarde wordt geciteerd. De standaardwaarde is dubbele aanhalingstekens. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY quote must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
ontsnappen
text Het teken dat moet worden weergegeven vóór een gegevensteken dat overeenkomt met de prijsopgavewaarde. De standaardwaarde is hetzelfde als de prijsopgavewaarde (zodat het aanhalingsteken wordt verdubbeld als het in de gegevens wordt weergegeven). Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY escape must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
force_quote
text[] dwingt het quoteren voor alle niet-NULL-waarden in elke opgegeven kolom te gebruiken. Null-uitvoer wordt nooit geciteerd. Als * is opgegeven, worden niet-NULL-waarden in alle kolommen vermeld.
force_not_null
text[] Komt niet overeen met de waarden van de opgegeven kolommen ten opzichte van de null-tekenreeks. In het standaardscenario waarin de null-tekenreeks leeg is, betekent dit dat lege waarden worden gelezen als tekenreeksen met de lengte nul in plaats van nullen, zelfs wanneer ze niet worden geciteerd.
force_null
text[] Koppel de waarden van de opgegeven kolommen aan de null-tekenreeks, zelfs als deze aangeeft. Als er een overeenkomst wordt gevonden, stelt u de waarde in op NULL. In het standaardscenario waarin de null-tekenreeks leeg is, wordt een lege tekenreeks tussen aanhalingstekens omgezet in NULL.
content_encoding
text Naam van de codering waarmee het bestand is gecodeerd. Als u deze optie weglaat, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb
azure_storage.options_parquet
De functie Hulpprogramma voor het decoderen van de inhoud van een Parquet-bestand. Gebruik deze als parameter in blob_get.
azure_storage.options_parquet();
Permissions
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
Resultaattype
jsonb
azure_storage.options_csv_get
De functie Hulpprogramma voor het decoderen van de inhoud van een CSV-bestand. Roep deze functie aan als een parameter binnen 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
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
scheidingsteken
text Het teken dat kolommen scheidt binnen elke rij (regel) van het bestand. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY delimiter must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
null_string
text De tekenreeks die een null-waarde vertegenwoordigt. De standaardwaarde is \N (backslash-N) in tekstindeling en een niet-aanhalingstekenloze lege tekenreeks in CSV-indeling. Mogelijk geeft u de voorkeur aan een lege tekenreeks, zelfs in tekstindeling voor gevallen waarin u null-waarden niet wilt onderscheiden van lege tekenreeksen.
koptekst
boolean Vlag die aangeeft of het bestand een koptekstregel bevat met de namen van elke kolom in het bestand. In de uitvoer bevat de eerste regel de kolomnamen uit de tabel.
prijsopgave
text Het aanhalingsteken dat moet worden gebruikt wanneer een gegevenswaarde wordt geciteerd. De standaardwaarde is dubbele aanhalingstekens. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY quote must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
ontsnappen
text Het teken dat moet worden weergegeven vóór een gegevensteken dat overeenkomt met de prijsopgavewaarde. De standaardwaarde is hetzelfde als de prijsopgavewaarde (zodat het aanhalingsteken wordt verdubbeld als het in de gegevens wordt weergegeven). Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY escape must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
force_not_null
text[] Komt niet overeen met de waarden van de opgegeven kolommen ten opzichte van de null-tekenreeks. In het standaardscenario waarin de null-tekenreeks leeg is, betekent dit dat lege waarden worden gelezen als tekenreeksen met de lengte nul in plaats van nullen, zelfs wanneer ze niet worden geciteerd.
force_null
text[] Koppel de waarden van de opgegeven kolommen aan de null-tekenreeks, zelfs als deze aangeeft. Als er een overeenkomst wordt gevonden, stelt u de waarde in op NULL. In het standaardscenario waarin de null-tekenreeks leeg is, wordt een lege tekenreeks tussen aanhalingstekens omgezet in NULL.
content_encoding
text Naam van de codering waarmee het bestand is gecodeerd. Als u deze optie weglaat, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb
azure_storage.options_tsv
De functie Hulpprogramma voor het decoderen van de inhoud van een TSV-bestand. Roep deze functie aan als een parameter binnen blob_get.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Permissions
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
scheidingsteken
text Het teken dat kolommen scheidt binnen elke rij (regel) van het bestand. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, retourneert PostgreSQL een COPY delimiter must be a single one-byte character fout als u meer dan één byteteken probeert te gebruiken.
null_string
text De tekenreeks die een null-waarde vertegenwoordigt. De standaardwaarde is \N (backslash-N) in tekstindeling en een niet-aanhalingstekenloze lege tekenreeks in CSV-indeling. Mogelijk geeft u de voorkeur aan een lege tekenreeks, zelfs in tekstindeling voor gevallen waarin u null-waarden niet wilt onderscheiden van lege tekenreeksen.
content_encoding
text Naam van de codering waarmee het bestand is gecodeerd. Als u deze optie weglaat, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb
azure_storage.options_binary
Hulpprogrammafunctie die u kunt aanroepen als een parameter binnen blob_get. Hiermee kunt u de inhoud van een binair bestand decoderen.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Permissions
Elke gebruiker of rol kan deze functie aanroepen.
Arguments
content_encoding
text Naam van de codering waarmee het bestand is gecodeerd. Als u deze optie weglaat, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb