Odkaz na funkce poskytované rozšířením Azure Storage na flexibilním serveru Azure Database for PostgreSQL

Následující seznam obsahuje funkce poskytované rozšířením Azure Storage:

azure_storage.account_add

Funkce, která přidá účet úložiště a jeho přidružený přístupový klíč do seznamu účtů úložiště, ke kterým azure_storage má rozšíření přístup.

Pokud předchozí vyvolání této funkce už přidalo odkaz na tento účet úložiště, nepřidá novou položku, ale aktualizuje přístupový klíč existující položky.

Poznámka:

Tato funkce neověřuje, jestli název odkazovaného účtu existuje nebo jestli je přístupný pomocí zadaného přístupového klíče. Ověří ale, že název účtu úložiště je platný podle ověřovacích pravidel pojmenování uložených pro účty úložiště Azure.

azure_storage.account_add(account_name_p text, account_key_p text);

Přetížená verze této funkce přijímá account_config parametr, který zapouzdřuje název odkazovaného účtu Azure Storage a všechna požadovaná nastavení, jako je typ ověřování, typ účtu nebo přihlašovací údaje k úložišti.

azure_storage.account_add(account_config jsonb);

Povolení

Musí být členem .azure_storage_admin

Arguments

account_name_p

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

account_key_p

text hodnota jednoho z přístupových klíčů pro účet úložiště. Přístupové klíče služby Azure Blob Storage se podobají kořenovému heslu pro váš účet úložiště. Vždy buďte opatrní při ochraně přístupových klíčů. Pomocí služby Azure Key Vault můžete klíče bezpečně spravovat a otáčet. Klíč účtu je uložený v tabulce, ke které má přístup jenom superuživatel. Uživatelé, kterým byla role udělena azure_storage_admin , můžou s touto tabulkou pracovat prostřednictvím funkcí. Pokud chcete zjistit, které účty úložiště se přidají, použijte funkci azure_storage.account_list.

account_config

jsonb název účtu Azure Storage a všechna požadovaná nastavení, jako je typ ověřování, typ účtu nebo přihlašovací údaje k úložišti. Pomocí funkcí nástroje azure_storage.account_options_managed_identity, azure_storage.account_options_credentials nebo azure_storage.account_options_options vytvořte některou z platných hodnot, které musíte předat jako tento argument.

Návratový typ

VOID

azure_storage.account_encrypt_existing_credentials

Funkce, která prohledá seznam existujících účtů úložiště, které jste přidali pomocí azure_storage.account_add ve starších verzích rozšíření. Tyto verze ukládají nešifrované přihlašovací údaje. Tato funkce šifruje všechny přihlašovací údaje pomocí klíče uloženého v azure_storage.credential_encryption_key. Hodnota azure_storage.credential_encryption_key je vymezena na úrovni serveru. Proto pokud vytvoříte rozšíření Azure Storage ve více databázích na stejném serveru, stejný šifrovací klíč zašifruje všechny citlivé přihlašovací údaje uložené rozšířením bez ohledu na databázi, ve které jsou uloženy.

Důležité

Pokud vytvoříte rozšíření Azure Storage ve více databázích stejného serveru, musíte funkci spustit azure_storage.account_encrypt_existing_credentials v každé z těchto databází.

azure_storage.account_encrypt_existing_credentials();

Povolení

Musí být členem .azure_storage_admin

Arguments

Tato funkce nepřebírají žádné argumenty.

Návratový typ

bigint Počet existujících přihlašovacích údajů účtu úložiště, které byly před spuštěním funkce nešifrované a jsou nyní zašifrovány pomocí klíče uloženého v azure_storage.credential_encryption_key.

azure_storage.account_options_managed_identity

Funkce, která funguje jako utility funkce. Volejte ho jako parametr v rámci azure_storage.account_add. Pomůže vám vytvořit platnou hodnotu argumentu account_config při použití spravované identity přiřazené systémem k interakci s Azure Storage účtem.

azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

název

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

typ

azure_storage.storage_type hodnota jednoho z podporovaných typů úložiště. Podporovaná hodnota je blob.

Návratový typ

jsonb

azure_storage.account_options_credentials

Utility funkce, kterou můžete volat jako parametr v rámci azure_storage.account_add. Pomůže vám vytvořit platnou hodnotu argumentu account_config při použití přístupového klíče Azure Storage k interakci s Azure Storage účtem.

azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

název

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

přihlašovací údaje

text hodnota jednoho z přístupových klíčů pro účet úložiště. Přístupové klíče služby Azure Blob Storage se podobají kořenovému heslu pro váš účet úložiště. Vždy buďte opatrní při ochraně přístupových klíčů. Pomocí služby Azure Key Vault můžete klíče bezpečně spravovat a otáčet. Klíč účtu je uložený v tabulce, ke které má přístup jenom superuživatel. Uživatelé, kterým byla role udělena azure_storage_admin , můžou s touto tabulkou pracovat prostřednictvím funkcí. Pokud chcete zjistit, které účty úložiště se přidají, použijte funkci azure_storage.account_list.

typ

azure_storage.storage_type hodnota jednoho z podporovaných typů úložiště. Podporovaná hodnota je blob.

Návratový typ

jsonb

azure_storage.account_options

Utility funkce, kterou můžete volat jako parametr v rámci azure_storage.account_add. Pomůže vám vytvořit platnou hodnotu argumentu account_config při použití Azure Storage přístupového klíče nebo spravované identity přiřazené systémem k interakci s účtem Azure Storage.

azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

název

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

auth_type

azure_storage.auth_type hodnota jednoho z podporovaných typů úložiště. Podporované hodnoty jsou access-key a managed-identity.

storage_type

azure_storage.storage_type hodnota jednoho z podporovaných typů úložiště. Podporovaná hodnota je blob.

přihlašovací údaje

text hodnota jednoho z přístupových klíčů pro účet úložiště. Přístupové klíče služby Azure Blob Storage se podobají kořenovému heslu pro váš účet úložiště. Vždy buďte opatrní při ochraně přístupových klíčů. Pomocí služby Azure Key Vault můžete klíče bezpečně spravovat a otáčet. Klíč účtu je uložený v tabulce, ke které má přístup jenom superuživatel. Uživatelé, kterým byla role udělena azure_storage_admin , můžou s touto tabulkou pracovat prostřednictvím funkcí. Pokud chcete zjistit, které účty úložiště se přidají, použijte funkci azure_storage.account_list.

Návratový typ

jsonb

azure_storage.account_remove

Funkce, která odebere účet úložiště a přidružený přístupový klíč ze seznamu účtů úložiště, ke kterým azure_storage má rozšíření přístup.

azure_storage.account_remove(account_name_p text);

Povolení

Musí být členem .azure_storage_admin

Arguments

account_name_p

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

Návratový typ

VOID

azure_storage.account_user_add

Funkce, která uděluje uživateli nebo roli PostgreSQL přístup k účtu úložiště prostřednictvím funkcí poskytovaných rozšířením azure_storage .

Poznámka:

Spuštění této funkce bude úspěšné pouze v případě, že účet úložiště, jehož název předáte jako první argument, již byl vytvořen pomocí příkazu azure_storage.account_add a pokud již existuje uživatel nebo role, jehož jméno předáte jako druhý argument.

azure_storage.account_add(account_name_p text, user_p regrole);

Povolení

Musí být členem .azure_storage_admin

Arguments

account_name_p

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

user_p

regrole název uživatele nebo role PostgreSQL, který je k dispozici na serveru.

Návratový typ

VOID

azure_storage.account_user_remove

Funkce, která odvolá přístup uživatele nebo role PostgreSQL k účtu úložiště prostřednictvím funkcí poskytovaných rozšířením azure_storage

Poznámka:

Spuštění této funkce proběhne pouze v případě, že účet úložiště, jehož název předáte jako první argument, již existuje a byl vytvořen pomocí příkazu azure_storage.account_add. Uživatel nebo role, jehož jméno předáte jako druhý argument, musí existovat také. Při vyřazení uživatele nebo role ze serveru spuštěním se DROP USER | ROLEautomaticky odeberou také oprávnění udělená u všech odkazů na Azure Storage účty.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Povolení

Musí být členem .azure_storage_admin

Arguments

account_name_p

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

user_p

regrole název uživatele nebo role PostgreSQL, který je k dispozici na serveru.

Návratový typ

VOID

azure_storage.account_list

Funkce, která uvádí názvy účtů úložiště, které jste nakonfigurovali prostřednictvím funkce azure_storage.account_add , spolu s uživateli nebo rolemi PostgreSQL, které mají oprávnění k interakci s tímto účtem úložiště prostřednictvím funkcí poskytovaných rozšířením azure_storage .

azure_storage.account_list();

Povolení

Musí být členem .azure_storage_admin

Arguments

Tato funkce nepřebírají žádné argumenty.

Návratový typ

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[])Tabulka se čtyřmi sloupci se seznamem přidaných účtů Azure Storage, typ ověřování používaný k interakci s jednotlivými účty, typ úložiště a seznam uživatelů nebo rolí PostgreSQL, které k němu mají přístup.

azure_storage.blob_list

Funkce, která uvádí názvy a další vlastnosti (velikost, lastModified, eTag, contentType, contentEncoding a contentHash) objektů blob uložených v daném kontejneru uvedeného účtu úložiště.

azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);

Povolení

Přidejte uživatele nebo roli, která vyvolá tuto funkci, do seznamu povolených pro danou account_name funkci spuštěním příkazu azure_storage.account_user_add. azure_storage_admin Členové mají automaticky povoleno odkazovat na všechny účty Azure Storage, jejichž odkazy byly přidány pomocí azure_storage.account_add.

Arguments

account_name

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

název_kontejneru

text název kontejneru. Kontejner uspořádá sadu objektů blob, podobně jako adresář v systému souborů. Účet úložiště může obsahovat neomezený počet kontejnerů a kontejner může obsahovat neomezený počet blobů. Název kontejneru musí být platný název DNS (Domain Name System), protože je součástí jedinečného identifikátoru URI použitého k adresování kontejneru nebo jeho objektů blob. Při pojmenování kontejneru postupujte podle těchto pravidel.

Identifikátor URI kontejneru je podobný následujícímu: https://myaccount.blob.core.windows.net/mycontainer

prefix

text po zadání vrátí funkce objekty blob, jejichž názvy začínají hodnotou zadanou v tomto parametru. Výchozí hodnota je prázdný řetězec.

Návratový typ

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) tabulka s jedním záznamem na vrácený objekt blob, včetně celého názvu objektu blob a některých dalších vlastností.

cesta

text úplný název objektu blob.

bytes

bigint velikost objektu blob v bajtech.

last_modified

timestamp with time zone datum a čas poslední změny objektu blob. Jakákoli operace, která upraví objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.

etag

text Vlastnost ETag se používá pro optimistickou souběžnost během aktualizací. Nejedná se o časové razítko, protože existuje jiná vlastnost s názvem Timestamp, která ukládá čas poslední aktualizace záznamu. Pokud například načtete entitu a chcete ji aktualizovat, musí eTag odpovídat aktuálně uložené entitě. Nastavení příslušné značky ETag je důležité, protože pokud máte více uživatelů, kteří upravují stejnou položku, nechcete, aby přepsali změny ostatních uživatelů.

content_type

text typ obsahu zadaný pro objekt blob. Výchozí typ obsahu je application/octet-stream.

content_encoding

text Vlastnost Content-Encoding objektu blob, který azure Storage umožňuje definovat. U komprimovaného obsahu můžete nastavit vlastnost na Gzip. Když prohlížeč přistupuje k obsahu, automaticky dekomprimuje obsah.

content_hash

text hodnota hash použitá k ověření integrity objektu blob během přenosu. Když zadáte tuto hlavičku, služba úložiště zkontroluje zadanou hodnotu hash proti té, kterou vypočítá z obsahu. Pokud se dvě hodnoty hash neshoduje, operace selže a vrátí kód chyby 400 (Chybný požadavek).

azure_storage.blob_get

Funkce, která importuje data stažením souboru z kontejneru objektů blob v účtu Azure Storage. Přeloží obsah na řádky, které můžete využívat a zpracovávat pomocí konstruktorů jazyka SQL. Tato funkce přidává podporu filtrování a manipulace s daty načtenými z kontejneru objektů blob před importem.

Poznámka:

Než se pokusíte získat přístup ke kontejneru pro uvedený účet úložiště, tato funkce zkontroluje, jestli názvy účtu úložiště a kontejneru, které předáváte jako argumenty, jsou platné podle ověřovacích pravidel pojmenování uložených pro účty úložiště Azure. Pokud je některý z názvů neplatný, vrátí funkce chybu.

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);

Přetížená verze této funkce přijímá rec parametr, který můžete použít k pohodlnému definování záznamu výstupního formátu.

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);

Povolení

Přidejte uživatele nebo roli, která vyvolá tuto funkci, do seznamu povolených pro danou account_name funkci spuštěním příkazu azure_storage.account_user_add. azure_storage_admin Členové mají automaticky povoleno odkazovat na všechny účty Azure Storage, jejichž odkazy byly přidány pomocí azure_storage.account_add.

Arguments

account_name

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

název_kontejneru

text název kontejneru. Kontejner uspořádá sadu objektů blob, podobně jako adresář v systému souborů. Účet úložiště může obsahovat neomezený počet kontejnerů a kontejner může obsahovat neomezený počet blobů. Název kontejneru musí být platný název DNS (Domain Name System), protože je součástí jedinečného identifikátoru URI použitého k adresování kontejneru nebo jeho objektů blob. Při pojmenování kontejneru postupujte podle těchto pravidel.

Identifikátor URI kontejneru je podobný následujícímu: https://myaccount.blob.core.windows.net/mycontainer

cesta

text úplný název objektu blob.

Rec

anyelement definice výstupní struktury záznamu.

dekodér

text specifikace formátu objektu blob. Nastavte na některou z následujících hodnot:

Formát výchozí Description
auto true Odvodí hodnotu na základě poslední řady znaků přiřazených k názvu objektu blob. Pokud název objektu blob končí .parquet, předpokládá parquet. Pokud končí .csv nebo .csv.gz, předpokládá csv. Pokud končí .tsv nebo .tsv.gz, předpokládá tsv. Pokud končí na .json, , .json.gz.xml, .xml.gz, .txtnebo .txt.gz, předpokládá text.
binary Binární formát PostgreSQL COPY.
csv Formát hodnot oddělených čárkami používaný nástrojem PostgreSQL COPY.
parquet Formát Parquet.
text | xml | json Soubor obsahující jednu textovou hodnotu.
tsv Hodnoty oddělené tabulátorem, výchozí formát PostgreSQL COPY.
komprese

text specifikace typu komprese. Nastavte na některou z následujících hodnot:

Formát výchozí Description
auto true Odvodí hodnotu na základě poslední řady znaků přiřazených k názvu objektu blob. Pokud název objektu blob končí .gz, předpokládá gzip. V opačném případě předpokládá none.
brotli Pomocí algoritmu komprese brotli zkomprimuje objekt blob. Podporuje parquet se jenom kodér.
gzip Vynutí použití algoritmu komprese gzip ke komprimaci objektu blob.
lz4 Pomocí algoritmu komprese lz4 komprimuje objekt blob. Kodér parquet je jediný kodér, který podporuje tento algoritmus.
none Nekomprimuje objekt blob.
snappy Pomocí algoritmu komprese snappy zkomprimuje objekt blob. Kodér parquet je jediný kodér, který podporuje tento algoritmus.
zstd Pomocí algoritmu komprese zstd komprimuje objekt blob. Kodér parquet je jediný kodér, který podporuje tento algoritmus.

Rozšíření nepodporuje žádné jiné typy komprese.

options

jsonb nastavení, která definují zpracování vlastních záhlaví, vlastních oddělovačů, řídicích znaků a dalších možností. options ovlivňuje chování této funkce způsobem podobným způsobem jako možnosti, které můžete předat COPY příkazu v PostgreSQL, ovlivňují jeho chování.

Návratový typ

SETOF record SETOF anyelement

azure_storage.blob_put

Funkce, která exportuje data nahráním souborů do kontejneru objektů blob v účtu Azure Storage Funkce vytvoří obsah souboru z řádků v PostgreSQL.

Poznámka:

Než se pokusíte získat přístup ke kontejneru pro uvedený účet úložiště, tato funkce zkontroluje, jestli názvy účtu úložiště a kontejneru, které předáváte jako argumenty, jsou platné podle ověřovacích pravidel pojmenování uložených pro účty úložiště Azure. Pokud je některý z názvů neplatný, vrátí funkce chybu.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;

Přetížená verze funkce obsahuje encoder parametr. Tento parametr použijte k určení kodéru, pokud ho nelze odvodit z rozšíření parametru path nebo když chcete přepsat odvozený kodér.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;

Přetížená verze funkce obsahuje compression parametr. Tento parametr použijte k určení komprese, pokud ji nelze odvodit z rozšíření parametru path nebo pokud chcete přepsat odvozenou kompresi.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;

Přetížená verze funkce obsahuje options parametr pro zpracování vlastních hlaviček, vlastních oddělovačů, řídicích znaků a dalších možností. Tento options parametr funguje podobně jako možnosti, které můžete předat COPY příkazu v PostgreSQL.

azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;

Povolení

Přidejte uživatele nebo roli, která vyvolá tuto funkci, do seznamu povolených pro danou account_name funkci spuštěním příkazu azure_storage.account_user_add. azure_storage_admin Členové mají automaticky povoleno odkazovat na všechny účty Azure Storage, jejichž odkazy byly přidány pomocí azure_storage.account_add.

Arguments

account_name

text název účtu služby Azure Blob Storage, který obsahuje všechny objekty: objekty blob, soubory, fronty a tabulky. Účet úložiště poskytuje jedinečný obor názvů, ke kterému můžete přistupovat odkudkoli na světě přes PROTOKOL HTTPS.

název_kontejneru

text název kontejneru. Kontejner uspořádá sadu objektů blob, podobně jako adresář v systému souborů. Účet úložiště může obsahovat neomezený počet kontejnerů a kontejner může obsahovat neomezený počet blobů. Název kontejneru musí být platný název DNS (Domain Name System), protože je součástí jedinečného identifikátoru URI použitého k adresování kontejneru nebo jeho objektů blob. Při pojmenování kontejneru postupujte podle těchto pravidel.

Identifikátor URI kontejneru je podobný následujícímu: https://myaccount.blob.core.windows.net/mycontainer

cesta

text úplný název objektu blob.

řazená kolekce členů

record definice výstupní struktury záznamu.

kodér

text specifikace formátu objektu blob. Nastavte na některou z následujících hodnot:

Formát výchozí Description
auto true Odvodí hodnotu na základě poslední řady znaků přiřazených k názvu objektu blob. Pokud název objektu blob končí .csv nebo .csv.gz, předpokládá csv. Pokud končí .tsv nebo .tsv.gz, předpokládá tsv. Pokud končí .jsonna , , .json.gz.xml, .xml.gz.txt, nebo .txt.gz, předpokládá text.
binary Binární formát PostgreSQL COPY.
csv Formát hodnot oddělených čárkami používaný nástrojem PostgreSQL COPY.
parquet Formát Parquet.
text | xml | json Soubor obsahující jednu textovou hodnotu.
tsv Hodnoty oddělené tabulátorem, výchozí formát PostgreSQL COPY.
komprese

text specifikace typu komprese. Nastavte na některou z následujících hodnot:

Formát výchozí Description
auto true Odvodí hodnotu na základě poslední řady znaků přiřazených k názvu objektu blob. Pokud název objektu blob končí .gz, předpokládá gzip. V opačném případě předpokládá none.
brotli Pomocí algoritmu komprese brotli zkomprimuje objekt blob. Podporuje parquet se jenom kodér.
gzip Vynutí použití algoritmu komprese gzip ke komprimaci objektu blob.
lz4 Pomocí algoritmu komprese lz4 komprimuje objekt blob. Kodér parquet je jediný kodér, který podporuje tento algoritmus.
none Nekomprimuje objekt blob.
snappy Pomocí algoritmu komprese snappy zkomprimuje objekt blob. Kodér parquet je jediný kodér, který podporuje tento algoritmus.
zstd Pomocí algoritmu komprese zstd komprimuje objekt blob. Kodér parquet je jediný kodér, který podporuje tento algoritmus.

Rozšíření nepodporuje žádné jiné typy komprese.

options

jsonb nastavení, která definují zpracování vlastních záhlaví, vlastních oddělovačů, řídicích znaků a dalších možností. options ovlivňuje chování této funkce způsobem podobným způsobem jako možnosti, které můžete předat COPY příkazu v PostgreSQL, ovlivňují jeho chování.

Návratový typ

VOID

azure_storage.options_copy

Utility funkce, kterou můžete volat jako parametr v rámci blob_get. Funguje jako pomocná funkce pro options_parquet, options_csv_get, options_tsv a 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);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

oddělovač

text Znak, který odděluje sloupce v každém řádku (řádku) souboru. Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY delimiter must be a single one-byte character PostgreSQL chybu.

null_string

text Řetězec, který představuje hodnotu null. Výchozí hodnota je \N (zpětné lomítko-N) v textovém formátu a necitovaný prázdný řetězec ve formátu CSV. Prázdný řetězec můžete preferovat i v textovém formátu v případech, kdy nechcete rozlišovat hodnoty null od prázdných řetězců.

boolean Příznak, který označuje, jestli soubor obsahuje řádek záhlaví s názvy jednotlivých sloupců v souboru. Ve výstupu obsahuje počáteční řádek názvy sloupců z tabulky.

kvóta

text Znak uvozování, který se použije při uvozování hodnoty dat. Výchozí hodnota je dvojitá uvozovka. Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY quote must be a single one-byte character PostgreSQL chybu.

uniknout

text Znak, který by se měl zobrazit před datovým znakem, který odpovídá hodnotě QUOTE. Výchozí hodnota je stejná jako hodnota QUOTE (aby se znak uvozovek zdvojnásobil, pokud se zobrazí v datech). Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY escape must be a single one-byte character PostgreSQL chybu.

force_quote

text[] vynutí použití uvozování pro všechny hodnoty, které nejsou null v každém zadaném sloupci. Výstup NULL se nikdy neuvozuje. Pokud je zadána hodnota *, hodnoty, které nemají hodnotu NULL, se uvozují ve všech sloupcích.

force_not_null

text[] Neodpovídají hodnotám zadaných sloupců s řetězcem null. Ve výchozím případě, kdy je řetězec null prázdný, znamená to, že prázdné hodnoty se čtou jako řetězce nulové délky místo hodnot null, i když nejsou v uvozovácích.

force_null

text[] Porovná hodnoty zadaných sloupců s řetězcem null i v případě uvozování. Pokud se najde shoda, nastavte hodnotu na HODNOTU NULL. Ve výchozím případě, kdy je řetězec null prázdný, převede uvozovaný prázdný řetězec na hodnotu NULL.

content_encoding

text Název kódování, pomocí kterého je soubor kódován. Pokud tuto možnost vynecháte, použije se aktuální kódování klienta.

Návratový typ

jsonb

azure_storage.options_parquet

Utility funkce pro dekódování obsahu souboru Parquet. Použijte ho jako parametr v blob_getsouboru .

azure_storage.options_parquet();

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

Návratový typ

jsonb

azure_storage.options_csv_get

Utility funkce pro dekódování obsahu souboru CSV. Volání této funkce jako parametru v rámci 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);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

oddělovač

text Znak, který odděluje sloupce v každém řádku (řádku) souboru. Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY delimiter must be a single one-byte character PostgreSQL chybu.

null_string

text Řetězec, který představuje hodnotu null. Výchozí hodnota je \N (zpětné lomítko-N) v textovém formátu a necitovaný prázdný řetězec ve formátu CSV. Prázdný řetězec můžete preferovat i v textovém formátu v případech, kdy nechcete rozlišovat hodnoty null od prázdných řetězců.

hlavička

boolean Příznak, který označuje, jestli soubor obsahuje řádek záhlaví s názvy jednotlivých sloupců v souboru. Ve výstupu obsahuje počáteční řádek názvy sloupců z tabulky.

kvóta

text Znak uvozování, který se použije při uvozování hodnoty dat. Výchozí hodnota je dvojitá uvozovka. Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY quote must be a single one-byte character PostgreSQL chybu.

uniknout

text Znak, který by se měl zobrazit před datovým znakem, který odpovídá hodnotě QUOTE. Výchozí hodnota je stejná jako hodnota QUOTE (aby se znak uvozovek zdvojnásobil, pokud se zobrazí v datech). Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY escape must be a single one-byte character PostgreSQL chybu.

force_not_null

text[] Neodpovídají hodnotám zadaných sloupců s řetězcem null. Ve výchozím případě, kdy je řetězec null prázdný, znamená to, že prázdné hodnoty se čtou jako řetězce nulové délky místo hodnot null, i když nejsou v uvozovácích.

force_null

text[] Porovná hodnoty zadaných sloupců s řetězcem null i v případě uvozování. Pokud se najde shoda, nastavte hodnotu na HODNOTU NULL. Ve výchozím případě, kdy je řetězec null prázdný, převede uvozovaný prázdný řetězec na hodnotu NULL.

content_encoding

text Název kódování, pomocí kterého je soubor kódován. Pokud tuto možnost vynecháte, použije se aktuální kódování klienta.

Návratový typ

jsonb

azure_storage.options_tsv

Utility funkce pro dekódování obsahu souboru TSV. Volání této funkce jako parametru v rámci blob_get.

azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

oddělovač

text Znak, který odděluje sloupce v každém řádku (řádku) souboru. Musí to být jeden 1 bajtový znak. I když tato funkce podporuje oddělovače libovolného počtu znaků, pokud se pokusíte použít více než jeden 1 bajtový znak, vrátí COPY delimiter must be a single one-byte character PostgreSQL chybu.

null_string

text Řetězec, který představuje hodnotu null. Výchozí hodnota je \N (zpětné lomítko-N) v textovém formátu a necitovaný prázdný řetězec ve formátu CSV. Prázdný řetězec můžete preferovat i v textovém formátu v případech, kdy nechcete rozlišovat hodnoty null od prázdných řetězců.

content_encoding

text Název kódování, pomocí kterého je soubor kódován. Pokud tuto možnost vynecháte, použije se aktuální kódování klienta.

Návratový typ

jsonb

azure_storage.options_binary

Utility funkce, kterou můžete volat jako parametr v rámci blob_get. Pomáhá dekódovat obsah binárního souboru.

azure_storage.options_binary(content_encoding text DEFAULT NULL::text);

Povolení

Tuto funkci může vyvolat libovolný uživatel nebo role.

Arguments

content_encoding

text Název kódování, pomocí kterého je soubor kódován. Pokud tuto možnost vynecháte, použije se aktuální kódování klienta.

Návratový typ

jsonb