Odkaz na funkce poskytované rozšířením Azure Storage ve službě Azure Database for PostgreSQL

Následuje seznam funkcí poskytovaných rozšířením Azure Storage:

azure_storage.account_add

Funkce, která umožňuje přidat úč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);

Existuje přetížená verze této funkce, která přijímá account_config parametr, který zapouzdřuje název odkazovaného účtu služby 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

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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, která je přístupná pouze superuživatelem. 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. Doporučujeme použít funkce nástroje azure_storage.account_options_managed_identity, azure_storage.account_options_credentials nebo azure_storage.account_options_options k vytvoření některé z platných hodnot, které musí být předány jako tento argument.

Návratový typ

VOID

azure_storage.account_options_managed_identity

Funkce, která funguje jako utility funkce, kterou lze volat jako parametr v rámci azure_storage.account_add a je užitečná k vytvoření platné hodnoty argumentu account_config při použití spravované identity přiřazené systémem pro interakci s účtem Azure Storage.

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

Povolení

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

Argumenty

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ů, který je přístupný odkudkoli na světě přes HTTPS.

typ

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

Návratový typ

jsonb

azure_storage.account_options_credentials

Funkce, která funguje jako utility funkce, která se dá volat jako parametr v rámci azure_storage.account_add a je užitečná k vytvoření platné hodnoty argumentu account_config při použití přístupového klíče Azure Storage k interakci s účtem Azure Storage.

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.

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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, která je přístupná pouze superuživatelem. 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 blobpouze .

Návratový typ

jsonb

azure_storage.account_options

Funkce, která funguje jako utility funkce, která se dá volat jako parametr v rámci azure_storage.account_add a je užitečná k vytvoření platné hodnoty argumentu account_config při použití přístupového klíče Azure Storage nebo spravované identity přiřazené systémem pro 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.

Argumenty

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ů, který je přístupný odkudkoli na světě přes HTTPS.

auth_type

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

storage_type

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

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, která je přístupná pouze superuživatelem. 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á umožňuje odebrání účtu úložiště a jeho přidruženého přístupového klíče 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

Argumenty

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ů, který je přístupný odkudkoli na světě přes HTTPS.

Návratový typ

VOID

azure_storage.account_user_add

Funkce, která umožňuje udělit 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 je úspěšné pouze v případě, že účet úložiště, jehož název se předává jako první argument, již byl vytvořen pomocí azure_storage.account_add a pokud již existuje uživatel nebo role, jehož název je předán jako druhý argument.

azure_storage.account_add(account_name_p text, user_p regrole);

Povolení

Musí být členem .azure_storage_admin

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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á umožňuje odvolání přístupu 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 se předává jako první argument, již byl vytvořen pomocí azure_storage.account_add, a pokud uživatel nebo role, jejíž název je předán jako druhý argument, stále existuje. Při vyřazení uživatele nebo role ze serveru spuštěním se DROP USER | ROLEautomaticky odstraní také oprávnění udělená u všech odkazů na účty Azure Storage.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Povolení

Musí být členem .azure_storage_admin

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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ě nakonfigurovaných prostřednictvím funkce azure_storage.account_add spolu s uživateli nebo rolemi PostgreSQL, kterým jsou udělena 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

Argumenty

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, typem ověřování používaného k interakci s každým účtem, typem úložiště a seznamem uživatelů nebo rolí PostgreSQL, kterým je udělen 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í

Uživatel nebo role, které tuto funkci vyvolávají, musí být přidány do seznamu povolených pro account_name odkazované spuštěním 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.

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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 nezapomeňte postupovat podle těchto pravidel.

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

předpona

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.

bajtů

bigint velikost objektu blob v bajtech.

last_modified

timestamp with time zonedatum 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. Pokud je tato hlavička zadaná, služba úložiště zkontroluje zadanou hodnotu hash s jednou vypočítanou z obsahu. Pokud se dvě hodnoty hash neshoduje, operace selže s kódem chyby 400 (Chybný požadavek).

azure_storage.blob_get

Funkce, která umožňuje import dat. Stáhne soubor z kontejneru objektů blob v účtu azure Storage. Pak přeloží obsah na řádky, které lze 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 jsou názvy účtu úložiště a kontejneru předané jako argumenty platné podle ověřovacích pravidel pojmenování uložených pro účty úložiště Azure. Pokud je některý z nich neplatný, vyvolá se chyba.

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

Existuje přetížená verze této funkce, která přijímá rec parametr, který umožňuje pohodlně definovat záznam 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í

Uživatel nebo role, které tuto funkci vyvolávají, musí být přidány do seznamu povolených pro account_name odkazované spuštěním 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.

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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 nezapomeňte postupovat 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. Lze nastavit na některou z následujících hodnot:

Formát	výchozí	Popis
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. Lze nastavit na některou z následujících hodnot:

Formát	výchozí	Popis
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		Vynutí použití algoritmu komprese brotli ke komprimaci objektu blob. Podporuje parquet se jenom kodér.
gzip		Vynutí použití algoritmu komprese gzip ke komprimaci objektu blob.
lz4		Vynutí použití algoritmu komprese lz4 ke kompresi objektu blob. Podporuje parquet se jenom kodér.
none		Vynutí, aby se objekt blob nezkomprimuje.
snappy		Vynutí použití algoritmu komprese snappy ke komprimaci objektu blob. Podporuje parquet se jenom kodér.
zstd		Vynutí použití algoritmu komprese zstd ke komprimaci objektu blob. Podporuje parquet se jenom kodér.

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

možnosti

jsonb nastavení definující zpracování vlastních hlaviček, vlastních oddělovačů, řídicích znaků atd. 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á umožňuje exportovat data tak, že nahraje soubory do kontejneru objektů blob v účtu Azure Storage. Obsah souborů se vytváří 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 jsou názvy účtu úložiště a kontejneru předané jako argumenty platné podle ověřovacích pravidel pojmenování uložených pro účty úložiště Azure. Pokud je některý z nich neplatný, vyvolá se chyba.

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

Existuje přetížená verze funkce, která obsahuje encoder parametr, který umožňuje určit kodér, který se má použít, když ho nelze odvodit z rozšíření parametru path nebo když chcete přepsat odvozený parametr.

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

Existuje přetížená verze funkce, která obsahuje compression také parametr, který umožňuje určit kompresi, která se má použít, když ji nelze odvodit z rozšíření parametru path nebo když chcete přepsat odvozenou verzi.

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

Existuje přetížená verze funkce, která obsahuje options také parametr pro zpracování vlastních hlaviček, vlastních oddělovačů, řídicích znaků atd. options funguje podobně jako možnosti, které lze 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í

Uživatel nebo role, které tuto funkci vyvolávají, musí být přidány do seznamu povolených pro account_name odkazované spuštěním 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.

Argumenty

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ů, který je přístupný odkudkoli na světě přes 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 nezapomeňte postupovat 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. Lze nastavit na některou z následujících hodnot:

Formát	výchozí	Popis
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čí 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. Lze nastavit na některou z následujících hodnot:

Formát	výchozí	Popis
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		Vynutí použití algoritmu komprese brotli ke komprimaci objektu blob. Podporuje parquet se jenom kodér.
gzip		Vynutí použití algoritmu komprese gzip ke komprimaci objektu blob.
lz4		Vynutí použití algoritmu komprese lz4 ke kompresi objektu blob. Podporuje parquet se jenom kodér.
none		Vynutí, aby se objekt blob nezkomprimuje.
snappy		Vynutí použití algoritmu komprese snappy ke komprimaci objektu blob. Podporuje parquet se jenom kodér.
zstd		Vynutí použití algoritmu komprese zstd ke komprimaci objektu blob. Podporuje parquet se jenom kodér.

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

možnosti

jsonb nastavení definující zpracování vlastních hlaviček, vlastních oddělovačů, řídicích znaků atd. 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

Funkce, která funguje jako utility funkce, kterou lze 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.

Argumenty

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, PostgreSQL hlásí chybu COPY delimiter must be a single one-byte character .

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í datové hodnoty. 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, PostgreSQL hlásí chybu COPY quote must be a single one-byte character .

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, PostgreSQL hlásí chybu COPY escape must be a single one-byte character .

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 když je uvozováno, a pokud je nalezena 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í, se kterým je soubor kódován. Pokud je tato možnost vynechána, použije se aktuální kódování klienta.

Návratový typ

jsonb

azure_storage.options_parquet

Funkce, která funguje jako utility funkce, která může být volána jako parametr uvnitř blob_geta je užitečná pro dekódování obsahu souboru parquet.

azure_storage.options_parquet();

Povolení

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

Argumenty

Návratový typ

jsonb

azure_storage.options_csv_get

Funkce, která funguje jako utility funkce, kterou lze volat jako parametr uvnitř blob_geta je užitečná pro dekódování obsahu souboru CSV.

azure_storage.options_csv_get(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);

Povolení

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

Argumenty

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, PostgreSQL hlásí chybu COPY delimiter must be a single one-byte character .

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í datové hodnoty. 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, PostgreSQL hlásí chybu COPY quote must be a single one-byte character .

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, PostgreSQL hlásí chybu COPY escape must be a single one-byte character .

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 když je uvozováno, a pokud je nalezena 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í, se kterým je soubor kódován. Pokud je tato možnost vynechána, použije se aktuální kódování klienta.

Návratový typ

jsonb

azure_storage.options_tsv

Funkce, která funguje jako utility funkce, která může být volána jako parametr uvnitř blob_geta je užitečná pro dekódování obsahu souboru tsv.

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.

Argumenty

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, PostgreSQL hlásí chybu COPY delimiter must be a single one-byte character .

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í, se kterým je soubor kódován. Pokud je tato možnost vynechána, použije se aktuální kódování klienta.

Návratový typ

jsonb

azure_storage.options_binary

Funkce, která funguje jako utility funkce, která může být volána jako parametr uvnitř blob_get, a je užitečná pro dekódování obsahu 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.

Argumenty

content_encoding

text název kódování, se kterým je soubor kódován. Pokud je tato možnost vynechána, použije se aktuální kódování klienta.

Návratový typ

jsonb

Související obsah

• Rozšíření Azure Storage
• Nakonfigurujte rozšíření Azure Storage.
• Příklady rychlého startu
• Řešení chyb
• Rozšíření a moduly.