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.
Hieronder volgt de lijst met functies die worden geleverd door de Azure Storage-extensie:
azure_storage.account_add
Functie waarmee u een opslagaccount en de bijbehorende toegangssleutel kunt toevoegen 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);
Er is een overbelaste versie van deze functie, die een account_config parameter accepteert die de naam van het Azure Storage-account waarnaar wordt verwezen, en alle vereiste instellingen, zoals verificatietype, accounttype of opslagreferenties.
azure_storage.account_add(account_config jsonb);
Machtigingen
Moet lid zijn van azure_storage_admin.
Argumenten
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 overal ter wereld toegankelijk is 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 die alleen toegankelijk is voor de supergebruiker. Gebruikers die de azure_storage_admin rol hebben verleend, kunnen communiceren met deze tabel 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. U wordt aangeraden de hulpprogrammafuncties azure_storage.account_options_managed_identity, azure_storage.account_options_credentials of azure_storage.account_options te gebruiken om een van de geldige waarden te maken die als dit argument moeten worden doorgegeven.
Resultaattype
VOID
azure_storage.account_options_managed_identity
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen azure_storage.account_add, en is handig om een geldige waarde voor het argument te produceren 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);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
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 overal ter wereld toegankelijk is via HTTPS.
soort
azure_storage.storage_type de waarde van een van de ondersteunde typen opslag. Alleen ondersteunde waarde is blob.
Resultaattype
jsonb
azure_storage.account_options_credentials
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen azure_storage.account_add, en is handig om een geldige waarde voor het account_config argument te produceren 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);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
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 overal ter wereld toegankelijk is via HTTPS.
inloggegevens
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 die alleen toegankelijk is voor de supergebruiker. Gebruikers die de azure_storage_admin rol hebben verleend, kunnen communiceren met deze tabel via functies. Als u wilt zien welke opslagaccounts worden toegevoegd, gebruikt u de functie azure_storage.account_list.
soort
azure_storage.storage_type de waarde van een van de ondersteunde typen opslag. Alleen ondersteunde waarde is blob.
Resultaattype
jsonb
azure_storage.account_options
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen azure_storage.account_add, en is handig om een geldige waarde voor het account_config argument te produceren 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);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
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 overal ter wereld toegankelijk is via HTTPS.
auth_type
azure_storage.auth_type de waarde van een van de ondersteunde typen opslag. Alleen ondersteunde waarden zijn access-key, en managed-identity.
storage_type
azure_storage.storage_type de waarde van een van de ondersteunde typen opslag. Alleen ondersteunde waarde is blob.
inloggegevens
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 die alleen toegankelijk is voor de supergebruiker. Gebruikers die de azure_storage_admin rol hebben verleend, kunnen communiceren met deze tabel 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 waarmee een opslagaccount en de bijbehorende toegangssleutel kunnen worden verwijderd uit de lijst met opslagaccounts waartoe de azure_storage extensie toegang heeft.
azure_storage.account_remove(account_name_p text);
Machtigingen
Moet lid zijn van azure_storage_admin.
Argumenten
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 overal ter wereld toegankelijk is via HTTPS.
Resultaattype
VOID
azure_storage.account_user_add
Functie waarmee een PostgreSQL-gebruiker of -rol toegang kan worden verleend tot een opslagaccount via de functies van de azure_storage extensie.
Opmerking
De uitvoering van deze functie slaagt alleen als het opslagaccount, waarvan de naam wordt doorgegeven als het eerste argument, al is gemaakt met behulp van azure_storage.account_add en als de gebruiker of rol, waarvan de naam wordt doorgegeven als het tweede argument, al bestaat.
azure_storage.account_add(account_name_p text, user_p regrole);
Machtigingen
Moet lid zijn van azure_storage_admin.
Argumenten
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 overal ter wereld toegankelijk is 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 die het intrekken van een PostgreSQL-gebruiker of -roltoegang tot een opslagaccount toestaat via de functies van de azure_storage extensie.
Opmerking
De uitvoering van deze functie slaagt alleen als het opslagaccount waarvan de naam wordt doorgegeven als het eerste argument al is gemaakt met behulp van azure_storage.account_add en als de gebruiker of rol waarvan de naam wordt doorgegeven als het tweede argument nog steeds bestaat.
Wanneer een gebruiker of rol van de server wordt verwijderd door uit te DROP USER | ROLEvoeren, worden de machtigingen die zijn verleend op een verwijzing naar Azure Storage-accounts ook automatisch verwijderd.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Machtigingen
Moet lid zijn van azure_storage_admin.
Argumenten
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 overal ter wereld toegankelijk is 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 zijn geconfigureerd via de functie azure_storage.account_add , samen met de PostgreSQL-gebruikers of -rollen die zijn gemachtigd om met dat opslagaccount te communiceren via de functies van de azure_storage extensie.
azure_storage.account_list();
Machtigingen
Moet lid zijn van azure_storage_admin.
Argumenten
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 Toegevoegde Azure Storage-accounts, het type verificatie dat wordt gebruikt voor interactie met elk account, het type opslag en de lijst met PostgreSQL-gebruikers of -rollen die toegang tot het account krijgen.
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);
Machtigingen
Gebruiker of rol die deze functie aanroept, moet worden toegevoegd aan de lijst met toegestane taken voor de account_name waarnaar wordt verwezen door azure_storage.account_user_add uit te voeren. Leden van de groep mogen automatisch verwijzen naar alle Azure Storage-accounts waarvan de verwijzingen zijn toegevoegd met behulp van azure_storage_adminazure_storage.account_add.
Argumenten
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 overal ter wereld toegankelijk is 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.
Zorg ervoor dat u deze regels volgt bij het benoemen van een container.
De URI voor een container is vergelijkbaar met: https://myaccount.blob.core.windows.net/mycontainer
voorvoegsel
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 zonede 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 deze header is opgegeven, controleert de opslagservice de opgegeven hash met één hash die wordt berekend op basis van inhoud. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Ongeldig verzoek).
azure_storage.blob_get
Functie waarmee gegevens kunnen worden geïmporteerd. Er wordt een bestand gedownload uit een blobcontainer in een Azure Storage-account. Vervolgens wordt de inhoud omgezet in rijen, die kunnen worden gebruikt en verwerkt met 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 als argumenten zijn doorgegeven, geldig zijn volgens de naamgevingsvalidatieregels die zijn opgelegd voor Azure-opslagaccounts. Als een van deze twee ongeldig is, wordt er een fout gegenereerd.
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);
Er is een overbelaste versie van deze functie, die een rec parameter accepteert waarmee u de uitvoerindelingrecord gemakkelijk kunt 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);
Machtigingen
Gebruiker of rol die deze functie aanroept, moet worden toegevoegd aan de lijst met toegestane taken voor de account_name waarnaar wordt verwezen door azure_storage.account_user_add uit te voeren. Leden van de groep mogen automatisch verwijzen naar alle Azure Storage-accounts waarvan de verwijzingen zijn toegevoegd met behulp van azure_storage_adminazure_storage.account_add.
Argumenten
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 overal ter wereld toegankelijk is 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.
Zorg ervoor dat u deze regels volgt 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. Kan worden 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 , , , , .json, of .json.gz.xml, wordt ervan uitgegaan .xml.gz. .txt.txt.gztext |
csv |
Door komma's gescheiden waardenindeling die wordt gebruikt door PostgreSQL COPY. | |
tsv |
Door tabs gescheiden waarden, de standaardIndeling PostgreSQL COPY. | |
binary |
Binaire PostgreSQL COPY-indeling. | |
text | xml | json |
Een bestand met één tekstwaarde. |
compressie
text de specificatie van het compressietype. Kan worden 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. |
gzip |
Dwingt het gebruik van gzip-decoder om de blob te decomprimeren. | |
none |
Krachten om de blob te behandelen als een blob die geen decompressie vereist. |
De extensie biedt geen ondersteuning voor andere compressietypen.
Opties
jsonb de instellingen voor het afhandelen van aangepaste headers, aangepaste scheidingstekens, escapetekens, enzovoort. 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 u gegevens kunt exporteren door bestanden te uploaden naar een blobcontainer in een Azure Storage-account. De inhoud van de bestanden wordt geproduceerd uit 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 als argumenten zijn doorgegeven, geldig zijn volgens de naamgevingsvalidatieregels die zijn opgelegd voor Azure-opslagaccounts. Als een van deze twee ongeldig is, wordt er een fout gegenereerd.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
Er is een overbelaste versie van de functie, die parameter bevat encoder waarmee u de encoder kunt opgeven die moet worden gebruikt wanneer deze niet kan worden afgeleid van de extensie van de path parameter, of wanneer u de parameter wilt overschrijven.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
Er is een overbelaste versie van de functie die ook een compression parameter bevat waarmee u de compressie kunt opgeven die moet worden gebruikt wanneer deze niet kan worden afgeleid van de extensie van de path parameter, of wanneer u de compressie wilt overschrijven.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Er is een overbelaste versie van de functie die ook een options parameter bevat voor het verwerken van aangepaste headers, aangepaste scheidingstekens, escapetekens, enzovoort. options Werkt op dezelfde manier als de opties die kunnen worden doorgegeven 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;
Machtigingen
Gebruiker of rol die deze functie aanroept, moet worden toegevoegd aan de lijst met toegestane taken voor de account_name waarnaar wordt verwezen door azure_storage.account_user_add uit te voeren. Leden van de groep mogen automatisch verwijzen naar alle Azure Storage-accounts waarvan de verwijzingen zijn toegevoegd met behulp van azure_storage_adminazure_storage.account_add.
Argumenten
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 overal ter wereld toegankelijk is 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.
Zorg ervoor dat u deze regels volgt 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. Kan worden 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 , , , , .json, of .json.gz.xml, wordt ervan uitgegaan .xml.gz. .txt.txt.gztext |
csv |
Door komma's gescheiden waardenindeling die wordt gebruikt door PostgreSQL COPY. | |
tsv |
Door tabs gescheiden waarden, de standaardIndeling PostgreSQL COPY. | |
binary |
Binaire PostgreSQL COPY-indeling. | |
text | xml | json |
Een bestand met één tekstwaarde. |
compressie
text de specificatie van het compressietype. Kan worden 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. |
gzip |
Dwingt het gebruik van gzip-decoder om de blob te decomprimeren. | |
none |
Krachten om de blob te behandelen als een blob die geen decompressie vereist. |
De extensie biedt geen ondersteuning voor andere compressietypen.
Opties
jsonb de instellingen voor het afhandelen van aangepaste headers, aangepaste scheidingstekens, escapetekens, enzovoort. 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_csv_get
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen blob_get, en is handig voor het decoderen van de inhoud van een CSV-bestand.
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);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
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, meldt 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.
citaat
text het aanhalingsteken dat moet worden gebruikt wanneer een gegevenswaarde wordt aanhalingstekens. De standaardwaarde is dubbele aanhalingstekens. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, meldt 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, meldt 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[] komen 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 wordt aanhalingstekens gegeven en 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 de optie wordt weggelaten, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb
azure_storage.options_copy
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen blob_get. Het fungeert als helperfunctie voor 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);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
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, meldt 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.
citaat
text het aanhalingsteken dat moet worden gebruikt wanneer een gegevenswaarde wordt aanhalingstekens. De standaardwaarde is dubbele aanhalingstekens. Het moet één byteteken zijn. Hoewel deze functie scheidingstekens van een willekeurig aantal tekens ondersteunt, meldt 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, meldt 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[] komen 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 wordt aanhalingstekens gegeven en 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 de optie wordt weggelaten, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb
azure_storage.options_tsv
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen blob_get, en is handig voor het decoderen van de inhoud van een tsv-bestand.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
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, meldt 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 de optie wordt weggelaten, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb
azure_storage.options_binary
Functie die fungeert als een hulpprogrammafunctie, die kan worden aangeroepen als een parameter binnen blob_get, en is handig voor het decoderen van de inhoud van een binair bestand.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Machtigingen
Elke gebruiker of rol kan deze functie aanroepen.
Argumenten
content_encoding
text naam van de codering waarmee het bestand is gecodeerd. Als de optie wordt weggelaten, wordt de huidige clientcodering gebruikt.
Resultaattype
jsonb