Verwijzing naar functies van de Azure Storage-extensie in Azure Database for PostgreSQL flexibele server

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.

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