Az Azure Storage-bővítmény által az Azure Database for PostgreSQL-ben biztosított függvények referenciája

Az Alábbi lista az Azure Storage-bővítmény által biztosított függvények listáját tartalmazza:

azure_storage.account_add

Olyan függvény, amely lehetővé teszi egy tárfiók és a hozzá tartozó hozzáférési kulcs hozzáadását azon tárfiókok listájához, amelyekhez a azure_storage bővítmény hozzáférhet.

Ha a függvény egy korábbi meghívása már hozzáadta a tárfiókra mutató hivatkozást, nem ad hozzá új bejegyzést, hanem frissíti a meglévő bejegyzés hozzáférési kulcsát.

Megjegyzés:

Ez a függvény nem ellenőrzi, hogy létezik-e a hivatkozott fiók neve, vagy elérhető-e a megadott hozzáférési kulccsal. Ellenőrzi azonban, hogy a tárfiók neve érvényes-e az Azure Storage-fiókokra vonatkozó elnevezési érvényesítési szabályok szerint.

azure_storage.account_add(account_name_p text, account_key_p text);

A függvény egy túlterhelt verziója fogadja el account_config a hivatkozott Azure Storage-fiók nevét tartalmazó paramétert, valamint az összes szükséges beállítást, például a hitelesítési típust, a fióktípust vagy a tárolási hitelesítő adatokat.

azure_storage.account_add(account_config jsonb);

Engedélyek

A (2) csoport tagjának azure_storage_adminkell lennie.

Érvek

account_name_p

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

account_key_p

text a tárfiók egyik hozzáférési kulcsának értéke. Az Azure Blob Storage hozzáférési kulcsai hasonlóak a tárfiók gyökérjelszójához. Mindig ügyeljen a hozzáférési kulcsok védelmére. Az Azure Key Vault használatával biztonságosan kezelheti és elforgathatja a kulcsokat. A fiókkulcs egy olyan táblában van tárolva, amely csak a felügyelő számára érhető el. A szerepkörrel azure_storage_admin rendelkező felhasználók függvényekkel kezelhetik ezt a táblát. A hozzáadott tárfiókok megtekintéséhez használja a azure_storage.account_list függvényt.

account_config

jsonb az Azure Storage-fiók neve és az összes szükséges beállítás, például a hitelesítési típus, a fiók típusa vagy a tár hitelesítő adatai. Javasoljuk, hogy a azure_storage.account_options_managed_identity, azure_storage.account_options_hitelesítő adatok vagy azure_storage.account_options segédprogramfüggvények használatával hozza létre az argumentumként átadott érvényes értékeket.

Visszatérési típus

VOID

azure_storage.account_options_managed_identity

A azure_storage.account_add paraméterként hívható, segédprogramfüggvényként működő függvény hasznos lehet az argumentum érvényes account_config értékének létrehozásához, ha egy rendszer által hozzárendelt felügyelt identitást használ az Azure Storage-fiókkal való interakcióhoz.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

név

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

típus

azure_storage.storage_type a támogatott tárolótípusok egyikének értéke. Csak a támogatott érték.blob

Visszatérési típus

jsonb

azure_storage.account_options_credentials

A azure_storage.account_add paraméterként hívható függvény, amely hasznos az argumentum érvényes account_config értékének létrehozásához, ha azure Storage-hozzáférési kulcsot használ az Azure Storage-fiókkal való interakcióhoz.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

név

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

azonosító adatok

text a tárfiók egyik hozzáférési kulcsának értéke. Az Azure Blob Storage hozzáférési kulcsai hasonlóak a tárfiók gyökérjelszójához. Mindig ügyeljen a hozzáférési kulcsok védelmére. Az Azure Key Vault használatával biztonságosan kezelheti és elforgathatja a kulcsokat. A fiókkulcs egy olyan táblában van tárolva, amely csak a felügyelő számára érhető el. A szerepkörrel azure_storage_admin rendelkező felhasználók függvényekkel kezelhetik ezt a táblát. A hozzáadott tárfiókok megtekintéséhez használja a azure_storage.account_list függvényt.

típus

azure_storage.storage_type a támogatott tárolótípusok egyikének értéke. Csak a támogatott érték.blob

Visszatérési típus

jsonb

azure_storage.account_options

A azure_storage.account_add paraméterként hívható függvény, amely hasznos az argumentum érvényes értékének account_config létrehozásához, ha egy Azure Storage-hozzáférési kulcsot vagy egy rendszer által hozzárendelt felügyelt identitást használ az Azure Storage-fiókkal való interakcióhoz.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

név

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

auth_type

azure_storage.auth_type a támogatott tárolótípusok egyikének értéke. Csak a támogatott értékek és a access-keymanaged-identity.

storage_type

azure_storage.storage_type a támogatott tárolótípusok egyikének értéke. Csak a támogatott érték.blob

azonosító adatok

text a tárfiók egyik hozzáférési kulcsának értéke. Az Azure Blob Storage hozzáférési kulcsai hasonlóak a tárfiók gyökérjelszójához. Mindig ügyeljen a hozzáférési kulcsok védelmére. Az Azure Key Vault használatával biztonságosan kezelheti és elforgathatja a kulcsokat. A fiókkulcs egy olyan táblában van tárolva, amely csak a felügyelő számára érhető el. A szerepkörrel azure_storage_admin rendelkező felhasználók függvényekkel kezelhetik ezt a táblát. A hozzáadott tárfiókok megtekintéséhez használja a azure_storage.account_list függvényt.

Visszatérési típus

jsonb

azure_storage.account_remove

A tárfiók és a hozzá tartozó hozzáférési kulcs eltávolítását lehetővé tevő függvény a bővítmény által elérhető tárfiókok azure_storage listájából.

azure_storage.account_remove(account_name_p text);

Engedélyek

A (2) csoport tagjának azure_storage_adminkell lennie.

Érvek

account_name_p

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

Visszatérési típus

VOID

azure_storage.account_user_add

Olyan függvény, amely lehetővé teszi a PostgreSQL-felhasználó vagy szerepkör hozzáférését egy tárfiókhoz a azure_storage bővítmény által biztosított függvényeken keresztül.

Megjegyzés:

A függvény végrehajtása csak akkor sikeres, ha az első argumentumként átadott tárfiók már létrejött azure_storage.account_add használatával, és már létezik az a felhasználó vagy szerepkör, akinek a nevét a második argumentumként adja át.

azure_storage.account_add(account_name_p text, user_p regrole);

Engedélyek

A (2) csoport tagjának azure_storage_adminkell lennie.

Érvek

account_name_p

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

user_p

regrole a kiszolgálón elérhető PostgreSQL-felhasználó vagy szerepkör neve.

Visszatérési típus

VOID

azure_storage.account_user_remove

Olyan függvény, amely lehetővé teszi egy PostgreSQL-felhasználó vagy szerepkör hozzáférésének visszavonását egy tárfiókhoz a azure_storage bővítmény által biztosított függvényeken keresztül.

Megjegyzés:

A függvény végrehajtása csak akkor sikeres, ha a azure_storage.account_add használatával már létrejött az a tárfiók, amelynek a neve az első argumentumként van átadva, és a második argumentumként átadott felhasználó vagy szerepkör továbbra is létezik. Amikor egy felhasználót vagy szerepkört elvet a kiszolgálóról, a végrehajtással DROP USER | ROLEa rendszer automatikusan eltávolítja az Azure Storage-fiókokra való hivatkozáshoz megadott engedélyeket is.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Engedélyek

A (2) csoport tagjának azure_storage_adminkell lennie.

Érvek

account_name_p

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

user_p

regrole a kiszolgálón elérhető PostgreSQL-felhasználó vagy szerepkör neve.

Visszatérési típus

VOID

azure_storage.account_list

A azure_storage.account_add függvényen keresztül konfigurált tárfiókok nevét listázó függvény, valamint a PostgreSQL-felhasználókkal vagy szerepkörökkel együtt, amelyek a bővítmény által azure_storage biztosított függvényeken keresztül jogosultak a tárfiókkal való interakcióra.

azure_storage.account_list();

Engedélyek

A (2) csoport tagjának azure_storage_adminkell lennie.

Érvek

Ez a függvény nem vesz fel argumentumokat.

Visszatérési típus

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) egy négyoszlopos táblázat az Azure Storage-fiókok listájával, az egyes fiókokkal való interakcióhoz használt hitelesítés típusával, a tárterület típusával, valamint a Hozzá hozzáférést kapó PostgreSQL-felhasználók vagy szerepkörök listájával.

azure_storage.blob_list

A hivatkozott tárfiók adott tárolójában tárolt blobok nevét és egyéb tulajdonságait (méret, lastModified, eTag, contentType, contentType, contentEncoding és contentHash) felsoroló függvény.

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

Engedélyek

A függvényt megszólító felhasználót vagy szerepkört hozzá kell adni a account_name hivatkozott lista engedélyezett listájához a azure_storage.account_user_add futtatásával. A azure_storage_admin tagok automatikusan hivatkozhatnak az összes Olyan Azure Storage-fiókra, amelynek hivatkozásait a azure_storage.account_add használatával adták hozzá.

Érvek

account_name

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

tároló_neve

text egy tároló neve. A tárolók blobokat rendszereznek, hasonlóan a fájlrendszer könyvtáraihoz. A tárfiókok korlátlan számú tárolót tartalmazhatnak, a tárolók pedig korlátlan számú blobot tárolhatnak. A tárolónévnek érvényes dns-névnek kell lennie, mivel a tároló vagy a blobok címzéséhez használt egyedi URI részét képezi. Tároló elnevezésekor mindenképpen kövesse ezeket a szabályokat.

A tároló URI-ja a következőhöz hasonló: https://myaccount.blob.core.windows.net/mycontainer

előtag

text ha meg van adva, a függvény visszaadja azokat a blobokat, amelyeknek a neve az ebben a paraméterben megadott értékkel kezdődik. Alapértelmezett érték egy üres sztringre.

Visszatérési típus

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) egy blobonként egy rekordot tartalmazó tábla, beleértve a blob teljes nevét és néhány egyéb tulajdonságot.

elérési út

text a blob teljes neve.

byte

bigint a blob mérete bájtban.

last_modified

timestamp with time zonea blob utolsó módosításának dátuma és időpontja. Minden olyan művelet, amely módosítja a blobot, beleértve a blob metaadatainak vagy tulajdonságainak frissítését, megváltoztatja a blob utolsó módosítási időpontját.

ETag

text Az ETag tulajdonság a frissítések során az optimista egyidejűséghez használatos. Ez nem időbélyeg, mivel van egy másik timestamp nevű tulajdonság, amely a rekord legutóbbi frissítésének időpontját tárolja. Ha például betölt egy entitást, és frissíteni szeretné azt, az ETag-nek meg kell egyeznie a jelenleg tároltval. A megfelelő ETag beállítása azért fontos, mert ha több felhasználó szerkeszti ugyanazt az elemet, nem szeretné, hogy felülírják egymás módosításait.

content_type

text a blobhoz megadott tartalomtípus. Az alapértelmezett tartalomtípus a következő application/octet-stream.

content_encoding

text az Azure Storage által definiált blob Tartalomkódolási tulajdonsága. Tömörített tartalom esetén beállíthatja, hogy a tulajdonság Gzip legyen. Amikor a böngésző hozzáfér a tartalomhoz, az automatikusan kibontja a tartalmat.

content_hash

text a blob integritásának ellenőrzésére használt kivonat az átvitel során. Ha ez a fejléc meg van adva, a tárolási szolgáltatás a megadott kivonatot egy tartalomból kiszámított kivonattal ellenőrzi. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul.

azure_storage.blob_get

Az adatok importálását lehetővé tevő függvény. Letölt egy fájlt egy Blob-tárolóból egy Azure Storage-fiókban. Ezután sorba fordítja a tartalmat, amely SQL-nyelvi szerkezetekkel használható és feldolgozható. Ez a függvény támogatja a blobtárolóból beolvasott adatok szűrését és manipulálását az importálás előtt.

Megjegyzés:

A hivatkozott tárfiók tárolójának elérése előtt ez a függvény ellenőrzi, hogy a tárfiók és az argumentumként átadott tároló neve érvényes-e az Azure Storage-fiókokra vonatkozó elnevezési érvényesítési szabályok szerint. Ha bármelyik érvénytelen, hibaüzenet jelenik meg.

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

A függvénynek van egy túlterhelt verziója, amely elfogad egy rec paramétert, amely lehetővé teszi a kimeneti formátumrekord kényelmes definiálását.

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

Engedélyek

A függvényt megszólító felhasználót vagy szerepkört hozzá kell adni a account_name hivatkozott lista engedélyezett listájához a azure_storage.account_user_add futtatásával. A azure_storage_admin tagok automatikusan hivatkozhatnak az összes Olyan Azure Storage-fiókra, amelynek hivatkozásait a azure_storage.account_add használatával adták hozzá.

Érvek

account_name

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

tároló_neve

text egy tároló neve. A tárolók blobokat rendszereznek, hasonlóan a fájlrendszer könyvtáraihoz. A tárfiókok korlátlan számú tárolót tartalmazhatnak, a tárolók pedig korlátlan számú blobot tárolhatnak. A tárolónévnek érvényes dns-névnek kell lennie, mivel a tároló vagy a blobok címzéséhez használt egyedi URI részét képezi. Tároló elnevezésekor mindenképpen kövesse ezeket a szabályokat.

A tároló URI-ja a következőhöz hasonló: https://myaccount.blob.core.windows.net/mycontainer

elérési út

text a blob teljes neve.

Rec

anyelement a rekord kimeneti szerkezetének definíciója.

Dekóder

text a blobformátum specifikációja. A következő értékek bármelyikére állítható be:

Formátum	Alapértelmezett	Leírás
auto	true	A blob nevéhez rendelt utolsó karaktersorozat alapján következtet az értékre. Ha a blobnév a következővel .parquetvégződik, feltételezi parquet. Ha a végződés vagy .csv.csv.gzaz , akkor feltételezi csv. Ha a végződés vagy .tsv.tsv.gzaz , akkor feltételezi tsv. Ha a .jsonvégződés , .json.gz, .xml, .xml.gz, .txtvagy .txt.gz, azt feltételezi text.
binary		Bináris PostgreSQL COPY formátum.
csv		A PostgreSQL COPY által használt vesszővel tagolt értékek formátuma.
parquet		Parquet formátum.
text | xml | json		Egyetlen szöveges értéket tartalmazó fájl.
tsv		Tabulátorral tagolt értékek, az alapértelmezett PostgreSQL COPY formátum.

tömörítés

text a tömörítési típus specifikációja. A következő értékek bármelyikére állítható be:

Formátum	Alapértelmezett	Leírás
auto	true	A blob nevéhez rendelt utolsó karaktersorozat alapján következtet az értékre. Ha a blobnév a következővel .gzvégződik, feltételezi gzip. Ellenkező esetben feltételezi none.
brotli		A brotli-tömörítési algoritmus használatával kényszeríti a blob tömörítését. Csak a kódoló támogatja parquet .
gzip		Gzip-tömörítési algoritmus használatával kényszeríti a blob tömörítését.
lz4		Lz4 tömörítési algoritmus használatával kényszeríti a blob tömörítését. Csak a kódoló támogatja parquet .
none		Kényszeríti, hogy ne tömörítse a blobot.
snappy		A beépülő modulos tömörítési algoritmus használatával kényszeríti a blob tömörítését. Csak a kódoló támogatja parquet .
zstd		Kényszeríti a zstd tömörítési algoritmust a blob tömörítésére. Csak a kódoló támogatja parquet .

A bővítmény más tömörítési típusokat nem támogat.

beállítások

jsonb az egyéni fejlécek, egyéni elválasztók, feloldó karakterek stb. kezelését meghatározó beállítások. options a függvény viselkedését úgy befolyásolja, hogy a PostgreSQL-ben a parancsnak COPY átadható beállítások hogyan befolyásolják annak működését.

Visszatérési típus

SETOF record SETOF anyelement

azure_storage.blob_put

Az adatok exportálását lehetővé tevő függvény, ha fájlokat tölt fel egy Blob-tárolóba egy Azure Storage-fiókban. A fájlok tartalma a PostgreSQL soraiból jön létre.

Megjegyzés:

A hivatkozott tárfiók tárolójának elérése előtt ez a függvény ellenőrzi, hogy a tárfiók és az argumentumként átadott tároló neve érvényes-e az Azure Storage-fiókokra vonatkozó elnevezési érvényesítési szabályok szerint. Ha bármelyik érvénytelen, hibaüzenet jelenik meg.

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

A függvénynek van egy túlterhelt verziója, amely olyan paramétert encoder tartalmaz, amely lehetővé teszi a használni kívánt kódoló megadását, ha a paraméter bővítményéből path nem lehet következtetni, vagy ha felül szeretné bírálni a kikövetkeztetettet.

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

A függvény egy túlterhelt verziója is tartalmaz egy compression paramétert, amely lehetővé teszi a használandó tömörítés megadását, ha az nem vonható le a path paraméter bővítményéből, vagy ha felül szeretné bírálni a kikövetkeztetettet.

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

A függvény egy túlterhelt verziója is tartalmaz egy paramétert options az egyéni fejlécek, az egyéni elválasztók, a menekülő karakterek stb. kezelésére, options hasonlóan működik, mint a PostgreSQL parancsának COPY átadható beállítások.

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

Engedélyek

A függvényt megszólító felhasználót vagy szerepkört hozzá kell adni a account_name hivatkozott lista engedélyezett listájához a azure_storage.account_user_add futtatásával. A azure_storage_admin tagok automatikusan hivatkozhatnak az összes Olyan Azure Storage-fiókra, amelynek hivatkozásait a azure_storage.account_add használatával adták hozzá.

Érvek

account_name

text az összes objektumot tartalmazó Azure Blob Storage-fiók neve: blobok, fájlok, üzenetsorok és táblák. A tárfiók egy egyedi névteret biztosít, amely a világ bármely pontjáról elérhető HTTPS-en keresztül.

tároló_neve

text egy tároló neve. A tárolók blobokat rendszereznek, hasonlóan a fájlrendszer könyvtáraihoz. A tárfiókok korlátlan számú tárolót tartalmazhatnak, a tárolók pedig korlátlan számú blobot tárolhatnak. A tárolónévnek érvényes dns-névnek kell lennie, mivel a tároló vagy a blobok címzéséhez használt egyedi URI részét képezi. Tároló elnevezésekor mindenképpen kövesse ezeket a szabályokat.

A tároló URI-ja a következőhöz hasonló: https://myaccount.blob.core.windows.net/mycontainer

elérési út

text a blob teljes neve.

rekord

record a rekord kimeneti szerkezetének definíciója.

kódoló

text a blobformátum specifikációja. A következő értékek bármelyikére állítható be:

Formátum	Alapértelmezett	Leírás
auto	true	A blob nevéhez rendelt utolsó karaktersorozat alapján következtet az értékre. Ha a blobnév a következővel .csv végződik: vagy .csv.gz, feltételezi csv. Ha a végződés vagy .tsv.tsv.gzaz , akkor feltételezi tsv. Ha a .jsonvégződés , .json.gz, .xml, .xml.gz, .txtvagy .txt.gz, azt feltételezi text.
binary		Bináris PostgreSQL COPY formátum.
csv		A PostgreSQL COPY által használt vesszővel tagolt értékek formátuma.
parquet		Parquet formátum.
text | xml | json		Egyetlen szöveges értéket tartalmazó fájl.
tsv		Tabulátorral tagolt értékek, az alapértelmezett PostgreSQL COPY formátum.

tömörítés

text a tömörítési típus specifikációja. A következő értékek bármelyikére állítható be:

Formátum	Alapértelmezett	Leírás
auto	true	A blob nevéhez rendelt utolsó karaktersorozat alapján következtet az értékre. Ha a blobnév a következővel .gzvégződik, feltételezi gzip. Ellenkező esetben feltételezi none.
brotli		A brotli-tömörítési algoritmus használatával kényszeríti a blob tömörítését. Csak a kódoló támogatja parquet .
gzip		Gzip-tömörítési algoritmus használatával kényszeríti a blob tömörítését.
lz4		Lz4 tömörítési algoritmus használatával kényszeríti a blob tömörítését. Csak a kódoló támogatja parquet .
none		Kényszeríti, hogy ne tömörítse a blobot.
snappy		A beépülő modulos tömörítési algoritmus használatával kényszeríti a blob tömörítését. Csak a kódoló támogatja parquet .
zstd		Kényszeríti a zstd tömörítési algoritmust a blob tömörítésére. Csak a kódoló támogatja parquet .

A bővítmény más tömörítési típusokat nem támogat.

beállítások

jsonb az egyéni fejlécek, egyéni elválasztók, feloldó karakterek stb. kezelését meghatározó beállítások. options a függvény viselkedését úgy befolyásolja, hogy a PostgreSQL-ben a parancsnak COPY átadható beállítások hogyan befolyásolják annak működését.

Visszatérési típus

VOID

azure_storage.options_copy

Segédprogramfüggvényként működő függvény, amely paraméterként hívható meg a rendszeren belül blob_get. A options_parquet, options_csv_get, options_tsv és options_binary segítő funkciója.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

elválasztó karakter

text a fájl minden sorában (sorában) lévő oszlopokat elválasztó karakter. Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY delimiter must be a single one-byte character .

null_string

text null értéket képviselő sztring. Az alapértelmezett érték a \N (fordított perjel-N) szövegformátumban, és egy nem kvótált üres sztring CSV formátumban. Az üres sztringeket még szöveges formátumban is előnyben részesítheti olyan esetekben, amikor nem szeretné megkülönböztetni a null értékeket az üres sztringektől.

fejléc

boolean jelölő, amely jelzi, hogy a fájl tartalmaz-e fejlécsort a fájl egyes oszlopainak nevével. Kimeneten a kezdeti sor tartalmazza a tábla oszlopneveit.

árajánlat

text az adatértékek idézésekor használandó idézőjel. Az alapértelmezett érték a dupla idézőjel. Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY quote must be a single one-byte character .

menekülés

text az IDÉZŐJEL értéknek megfelelő adatkarakte előtt megjelenő karakter. Az alapértelmezett érték megegyezik az IDÉZŐJEL értékével (így az idéző karakter megduplázódik, ha az adatokban megjelenik). Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY escape must be a single one-byte character .

force_quote

text[] az egyes megadott oszlopokban lévő összes nem NULL értékre vonatkozó idézőerők. A NULL kimenet soha nem lesz idézve. Ha * van megadva, a nem NULL értékeket a rendszer az összes oszlopban idézi.

force_not_null

text[] nem egyeznek a megadott oszlopok értékei a null sztringgel. Az alapértelmezett esetben, ahol a null sztring üres, az azt jelenti, hogy az üres értékek null érték helyett nulla hosszúságú sztringekként lesznek beolvasva, még akkor is, ha nincsenek idézve.

force_null

text[] egyezzen a megadott oszlopok értékeivel a null sztringgel, még akkor is, ha idézve van, és ha talál egyezést, állítsa az értéket NULL értékre. Abban az alapértelmezett esetben, amikor a null sztring üres, az idézett üres sztringet NULL értékre konvertálja.

content_encoding

text annak a kódolásnak a neve, amellyel a fájl kódolva van. Ha a beállítás nincs megadva, a rendszer az aktuális ügyfélkódolást használja.

Visszatérési típus

jsonb

azure_storage.options_parquet

A függvény segédprogramfüggvényként működik, amely paraméterként hívható meg a fájlon belül blob_get, és hasznos egy parquet-fájl tartalmának dekódolására.

azure_storage.options_parquet();

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

Visszatérési típus

jsonb

azure_storage.options_csv_get

A függvény segédprogramfüggvényként működik, amely paraméterként hívható meg a csv-fájl blob_gettartalmának dekódolásakor.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

elválasztó karakter

text a fájl minden sorában (sorában) lévő oszlopokat elválasztó karakter. Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY delimiter must be a single one-byte character .

null_string

text null értéket képviselő sztring. Az alapértelmezett érték a \N (fordított perjel-N) szövegformátumban, és egy nem kvótált üres sztring CSV formátumban. Az üres sztringeket még szöveges formátumban is előnyben részesítheti olyan esetekben, amikor nem szeretné megkülönböztetni a null értékeket az üres sztringektől.

fejléc

boolean jelölő, amely jelzi, hogy a fájl tartalmaz-e fejlécsort a fájl egyes oszlopainak nevével. Kimeneten a kezdeti sor tartalmazza a tábla oszlopneveit.

árajánlat

text az adatértékek idézésekor használandó idézőjel. Az alapértelmezett érték a dupla idézőjel. Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY quote must be a single one-byte character .

menekülés

text az IDÉZŐJEL értéknek megfelelő adatkarakte előtt megjelenő karakter. Az alapértelmezett érték megegyezik az IDÉZŐJEL értékével (így az idéző karakter megduplázódik, ha az adatokban megjelenik). Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY escape must be a single one-byte character .

force_not_null

text[] nem egyeznek a megadott oszlopok értékei a null sztringgel. Az alapértelmezett esetben, ahol a null sztring üres, az azt jelenti, hogy az üres értékek null érték helyett nulla hosszúságú sztringekként lesznek beolvasva, még akkor is, ha nincsenek idézve.

force_null

text[] egyezzen a megadott oszlopok értékeivel a null sztringgel, még akkor is, ha idézve van, és ha talál egyezést, állítsa az értéket NULL értékre. Abban az alapértelmezett esetben, amikor a null sztring üres, az idézett üres sztringet NULL értékre konvertálja.

content_encoding

text annak a kódolásnak a neve, amellyel a fájl kódolva van. Ha a beállítás nincs megadva, a rendszer az aktuális ügyfélkódolást használja.

Visszatérési típus

jsonb

azure_storage.options_tsv

A függvény segédprogramfüggvényként működik, amely paraméterként hívható meg a fájlon belül blob_get, és hasznos egy tsv-fájl tartalmának dekódolására.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

elválasztó karakter

text a fájl minden sorában (sorában) lévő oszlopokat elválasztó karakter. Egy 1 bájtos karakternek kell lennie. Bár ez a függvény tetszőleges számú karaktert támogat, ha egynél több 1 bájtos karaktert próbál használni, a PostgreSQL hibát jelez COPY delimiter must be a single one-byte character .

null_string

text null értéket képviselő sztring. Az alapértelmezett érték a \N (fordított perjel-N) szövegformátumban, és egy nem kvótált üres sztring CSV formátumban. Az üres sztringeket még szöveges formátumban is előnyben részesítheti olyan esetekben, amikor nem szeretné megkülönböztetni a null értékeket az üres sztringektől.

content_encoding

text annak a kódolásnak a neve, amellyel a fájl kódolva van. Ha a beállítás nincs megadva, a rendszer az aktuális ügyfélkódolást használja.

Visszatérési típus

jsonb

azure_storage.options_binary

A függvény segédprogramfüggvényként működik, amely paraméterként hívható meg a fájlon belül blob_get, és hasznos a bináris fájlok tartalmának dekódolására.

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

Engedélyek

Ezt a függvényt bármely felhasználó vagy szerepkör meghívhatja.

Érvek

content_encoding

text annak a kódolásnak a neve, amellyel a fájl kódolva van. Ha a beállítás nincs megadva, a rendszer az aktuális ügyfélkódolást használja.

Visszatérési típus

jsonb

Kapcsolódó tartalom

• Azure Storage-bővítmény.
• Konfigurálja az Azure Storage-bővítményt.
• Rövid útmutató példák.
• Hibák elhárítása.
• Bővítmények és modulok.