Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Poniżej znajduje się lista funkcji udostępnianych przez rozszerzenie usługi Azure Storage:
azure_storage.account_add
Funkcja, która umożliwia dodawanie konta magazynu i skojarzonego z nim klucza dostępu do listy kont magazynu, do których azure_storage rozszerzenie może uzyskać dostęp.
Jeśli poprzednie wywołanie tej funkcji już dodało odwołanie do tego konta magazynu, nie dodaje nowego wpisu, ale zamiast tego aktualizuje klucz dostępu istniejącego wpisu.
Uwaga / Notatka
Ta funkcja nie sprawdza, czy określona nazwa konta istnieje lub czy jest dostępna z podanym kluczem dostępu. Sprawdza jednak, czy nazwa konta magazynu jest prawidłowa, zgodnie z regułami walidacji nazewnictwa nałożonymi na konta usługi Azure Storage.
azure_storage.account_add(account_name_p text, account_key_p text);
Istnieje przeciążona wersja tej funkcji, która akceptuje parametr, który hermetyzuje account_config nazwę przywoływanego konta usługi Azure Storage, oraz wszystkie wymagane ustawienia, takie jak typ uwierzytelniania, typ konta lub poświadczenia magazynu.
azure_storage.account_add(account_config jsonb);
Uprawnienia
Musi być członkiem .azure_storage_admin
Argumenty (w programowaniu)
account_name_p
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
account_key_p
text wartość jednego z kluczy dostępu dla konta magazynu. Klucze dostępu do usługi Azure Blob Storage są podobne do hasła głównego dla konta magazynu. Zawsze należy zachować ostrożność, aby chronić klucze dostępu. Usługa Azure Key Vault umożliwia bezpieczne zarządzanie kluczami i obracanie ich. Klucz konta jest przechowywany w tabeli, która jest dostępna tylko przez administratora. Użytkownicy, którym przyznano azure_storage_admin rolę, mogą wchodzić w interakcje z tą tabelą za pośrednictwem funkcji. Aby sprawdzić, które konta magazynu są dodawane, użyj funkcji azure_storage.account_list.
account_config
jsonb nazwa konta usługi Azure Storage i wszystkie wymagane ustawienia, takie jak typ uwierzytelniania, typ konta lub poświadczenia magazynu. Zalecamy użycie funkcji narzędziowych azure_storage.account_options_managed_identity, azure_storage.account_options_credentials lub azure_storage.account_options , aby utworzyć dowolne prawidłowe wartości, które muszą zostać przekazane jako ten argument.
Typ zwracany
VOID
azure_storage.account_options_managed_identity
Funkcja, która działa jako funkcja narzędzia, która może być wywoływana jako parametr w ramach azure_storage.account_add, i jest przydatna do utworzenia prawidłowej wartości argumentu account_config podczas korzystania z tożsamości zarządzanej przypisanej przez system do interakcji z kontem usługi Azure Storage.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
nazwa
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
typ
azure_storage.storage_type wartość jednego z obsługiwanych typów magazynu. Tylko obsługiwana wartość to blob.
Typ zwracany
jsonb
azure_storage.account_options_credentials
Funkcja, która działa jako funkcja narzędzia, która może być wywoływana jako parametr w pliku azure_storage.account_add, i jest przydatna do utworzenia prawidłowej wartości argumentu account_config przy użyciu klucza dostępu usługi Azure Storage w celu interakcji z kontem usługi Azure Storage.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
nazwa
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
dane logowania
text wartość jednego z kluczy dostępu dla konta magazynu. Klucze dostępu do usługi Azure Blob Storage są podobne do hasła głównego dla konta magazynu. Zawsze należy zachować ostrożność, aby chronić klucze dostępu. Usługa Azure Key Vault umożliwia bezpieczne zarządzanie kluczami i obracanie ich. Klucz konta jest przechowywany w tabeli, która jest dostępna tylko przez administratora. Użytkownicy, którym przyznano azure_storage_admin rolę, mogą wchodzić w interakcje z tą tabelą za pośrednictwem funkcji. Aby sprawdzić, które konta magazynu są dodawane, użyj funkcji azure_storage.account_list.
typ
azure_storage.storage_type wartość jednego z obsługiwanych typów magazynu. Tylko obsługiwana wartość to blob.
Typ zwracany
jsonb
azure_storage.account_options
Funkcja, która działa jako funkcja narzędzia, która może być wywoływana jako parametr w ramach azure_storage.account_add, i jest przydatna do tworzenia prawidłowej wartości argumentu account_config , w przypadku używania klucza dostępu usługi Azure Storage lub przypisanej przez system tożsamości zarządzanej do interakcji z kontem usługi Azure Storage.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
nazwa
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
auth_type
azure_storage.auth_type wartość jednego z obsługiwanych typów magazynu. Obsługiwane są access-keytylko wartości , i managed-identity.
storage_type
azure_storage.storage_type wartość jednego z obsługiwanych typów magazynu. Tylko obsługiwana wartość to blob.
dane logowania
text wartość jednego z kluczy dostępu dla konta magazynu. Klucze dostępu do usługi Azure Blob Storage są podobne do hasła głównego dla konta magazynu. Zawsze należy zachować ostrożność, aby chronić klucze dostępu. Usługa Azure Key Vault umożliwia bezpieczne zarządzanie kluczami i obracanie ich. Klucz konta jest przechowywany w tabeli, która jest dostępna tylko przez administratora. Użytkownicy, którym przyznano azure_storage_admin rolę, mogą wchodzić w interakcje z tą tabelą za pośrednictwem funkcji. Aby sprawdzić, które konta magazynu są dodawane, użyj funkcji azure_storage.account_list.
Typ zwracany
jsonb
azure_storage.account_remove
Funkcja, która umożliwia usunięcie konta magazynu i skojarzonego z nim klucza dostępu z listy kont magazynu, do których azure_storage rozszerzenie może uzyskać dostęp.
azure_storage.account_remove(account_name_p text);
Uprawnienia
Musi być członkiem .azure_storage_admin
Argumenty (w programowaniu)
account_name_p
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
Typ zwracany
VOID
azure_storage.account_user_add
Funkcja, która umożliwia przyznanie użytkownikowi lub roli postgreSQL dostępu do konta magazynu za pośrednictwem funkcji udostępnianych przez azure_storage rozszerzenie.
Uwaga / Notatka
Wykonanie tej funkcji powiedzie się tylko wtedy, gdy konto magazynu, którego nazwa jest przekazywana jako pierwszy argument, została już utworzona przy użyciu azure_storage.account_add, a jeśli użytkownik lub rola, której nazwa jest przekazywana jako drugi argument, już istnieje.
azure_storage.account_add(account_name_p text, user_p regrole);
Uprawnienia
Musi być członkiem .azure_storage_admin
Argumenty (w programowaniu)
account_name_p
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
user_p
regrole nazwa użytkownika lub roli postgreSQL dostępnej na serwerze.
Typ zwracany
VOID
azure_storage.account_user_remove
Funkcja, która umożliwia odwołanie użytkownika lub roli PostgreSQL dostępu do konta magazynu za pośrednictwem funkcji udostępnianych przez azure_storage rozszerzenie.
Uwaga / Notatka
Wykonanie tej funkcji powiedzie się tylko wtedy, gdy konto magazynu, którego nazwa jest przekazywana jako pierwszy argument, został już utworzony przy użyciu azure_storage.account_add, a jeśli użytkownik lub rola, której nazwa jest przekazywana jako drugi argument, nadal istnieje.
Gdy użytkownik lub rola zostanie porzucona z serwera, przez wykonanie DROP USER | ROLEpolecenia , uprawnienia, które zostały przyznane w dowolnym odwołaniu do kont usługi Azure Storage, również zostaną automatycznie wyeliminowane.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Uprawnienia
Musi być członkiem .azure_storage_admin
Argumenty (w programowaniu)
account_name_p
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
user_p
regrole nazwa użytkownika lub roli postgreSQL dostępnej na serwerze.
Typ zwracany
VOID
azure_storage.account_list
Funkcja zawierająca listę nazw kont magazynu skonfigurowanych za pośrednictwem funkcji azure_storage.account_add wraz z użytkownikami lub rolami postgreSQL, którym przyznano uprawnienia do interakcji z tym kontem magazynu za pośrednictwem funkcji udostępnianych przez azure_storage rozszerzenie.
azure_storage.account_list();
Uprawnienia
Musi być członkiem .azure_storage_admin
Argumenty (w programowaniu)
Ta funkcja nie bierze żadnych argumentów.
Typ zwracany
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) czterokolumna tabela z dodaną listą kont usługi Azure Storage, typem uwierzytelniania używanego do interakcji z poszczególnymi kontami, typem magazynu oraz listą użytkowników lub ról postgreSQL, którym udzielono dostępu.
azure_storage.blob_list
Funkcja, która wyświetla nazwy i inne właściwości (rozmiar, lastModified, eTag, contentType, contentEncoding i contentHash) obiektów blob przechowywanych w danym kontenerze określonego konta magazynu.
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
Uprawnienia
Użytkownik lub rola wywołująca tę funkcję musi zostać dodana do listy dozwolonych dla określonego account_name elementu, wykonując azure_storage.account_user_add. Członkowie programu azure_storage_admin mogą automatycznie odwoływać się do wszystkich kont usługi Azure Storage, których odwołania zostały dodane przy użyciu azure_storage.account_add.
Argumenty (w programowaniu)
account_name
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
nazwa_kontenera
text nazwa kontenera. Kontener organizuje zestaw blobów, podobnie jak katalog w systemie plików. Konto magazynowe może zawierać nieograniczoną liczbę kontenerów, a kontener może przechowywać nieograniczoną liczbę blobów.
Nazwa kontenera musi być prawidłową nazwą systemu nazw domen (DNS), ponieważ stanowi część unikatowego identyfikatora URI używanego do adresowania kontenera lub jego obiektów blob.
Podczas nazewnictwa kontenera upewnij się, że są one zgodne z tymi regułami.
Identyfikator URI kontenera jest podobny do następującego: https://myaccount.blob.core.windows.net/mycontainer
przedrostek
text po określeniu funkcja zwraca obiekty blob, których nazwy zaczynają się od wartości podanej w tym parametrze. Domyślnie jest to pusty ciąg.
Typ zwracany
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) zwracana tabela z jednym rekordem na obiekt blob, w tym pełną nazwą obiektu blob i innymi właściwościami.
ścieżka
text pełna nazwa obiektu blob.
B
bigint rozmiar obiektu blob w bajtach.
last_modified
timestamp with time zonedata i godzina ostatniej modyfikacji obiektu blob. Każda operacja modyfikująca obiekt blob, w tym aktualizacja metadanych lub właściwości obiektu blob, zmienia czas ostatniej modyfikacji obiektu blob.
Znacznik ETAG
text Właściwość ETag jest używana do optymistycznej współbieżności podczas aktualizacji. Nie jest to sygnatura czasowa, ponieważ istnieje inna właściwość o nazwie Sygnatura czasowa, która przechowuje ostatni raz rekord został zaktualizowany. Jeśli na przykład załadujesz jednostkę i chcesz ją zaktualizować, element ETag musi być zgodny z tym, co jest obecnie przechowywane. Ustawienie odpowiedniego elementu ETag jest ważne, ponieważ jeśli masz wielu użytkowników edytując ten sam element, nie chcesz, aby zastępowały zmiany siebie nawzajem.
content_type
text typ zawartości określony dla obiektu blob. Domyślnym typem zawartości jest application/octet-stream.
content_encoding
text właściwość Content-Encoding obiektu blob, który umożliwia zdefiniowanie usługi Azure Storage. W przypadku skompresowanej zawartości można ustawić właściwość na Gzip. Gdy przeglądarka uzyskuje dostęp do zawartości, automatycznie dekompresuje zawartość.
content_hash
text skrót używany do weryfikowania integralności obiektu blob podczas transportu. Po określeniu tego nagłówka usługa magazynu sprawdza podany skrót z jednym obliczonym z zawartości. Jeśli dwa skróty nie są zgodne, operacja zakończy się niepowodzeniem z kodem błędu 400 (nieprawidłowe żądanie).
azure_storage.blob_get
Funkcja umożliwiająca importowanie danych. Pobiera plik z kontenera obiektów blob na koncie usługi Azure Storage. Następnie tłumaczy zawartość na wiersze, które mogą być używane i przetwarzane przy użyciu konstrukcji języka SQL. Ta funkcja dodaje obsługę filtrowania i manipulowania danymi pobranymi z kontenera obiektów blob przed ich zaimportowaniem.
Uwaga / Notatka
Przed próbą uzyskania dostępu do kontenera dla określonego konta magazynu ta funkcja sprawdza, czy nazwy konta magazynu i kontenera przekazane jako argumenty są prawidłowe zgodnie z regułami walidacji nazewnictwa nałożonymi na konta usługi Azure Storage. Jeśli którykolwiek z nich jest nieprawidłowy, zostanie zgłoszony błąd.
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);
Istnieje przeciążona wersja tej funkcji, która akceptuje rec parametr, który umożliwia wygodne definiowanie rekordu formatu wyjściowego.
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);
Uprawnienia
Użytkownik lub rola wywołująca tę funkcję musi zostać dodana do listy dozwolonych dla określonego account_name elementu, wykonując azure_storage.account_user_add. Członkowie programu azure_storage_admin mogą automatycznie odwoływać się do wszystkich kont usługi Azure Storage, których odwołania zostały dodane przy użyciu azure_storage.account_add.
Argumenty (w programowaniu)
account_name
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
nazwa_kontenera
text nazwa kontenera. Kontener organizuje zestaw blobów, podobnie jak katalog w systemie plików. Konto magazynowe może zawierać nieograniczoną liczbę kontenerów, a kontener może przechowywać nieograniczoną liczbę blobów.
Nazwa kontenera musi być prawidłową nazwą systemu nazw domen (DNS), ponieważ stanowi część unikatowego identyfikatora URI używanego do adresowania kontenera lub jego obiektów blob.
Podczas nazewnictwa kontenera upewnij się, że są one zgodne z tymi regułami.
Identyfikator URI kontenera jest podobny do następującego: https://myaccount.blob.core.windows.net/mycontainer
ścieżka
text pełna nazwa obiektu blob.
Rec
anyelement definicja struktury danych wyjściowych rekordu.
Dekoder
text specyfikacja formatu obiektu blob. Można ustawić dowolną z następujących wartości:
| Format | Wartość domyślna | Opis |
|---|---|---|
auto |
true |
Wywnioskuje wartość na podstawie ostatniej serii znaków przypisanych do nazwy obiektu blob. Jeśli nazwa obiektu blob kończy się ciągiem .parquet, przyjmuje wartość parquet. Jeśli wartość kończy się ciągiem .csv lub .csv.gz, przyjmuje wartość csv. Jeśli wartość kończy się ciągiem .tsv lub .tsv.gz, przyjmuje wartość tsv. Jeśli kończy się ciągiem .json, , .json.gz, .xml.xml.gz, .txtlub .txt.gz, przyjmuje wartość text. |
binary |
Format kopiowania plików binarnych PostgreSQL. | |
csv |
Format wartości rozdzielonych przecinkami używany przez narzędzie PostgreSQL COPY. | |
parquet |
Format Parquet. | |
text | xml | json |
Plik zawierający pojedynczą wartość tekstową. | |
tsv |
Wartości rozdzielane tabulatorami, domyślny format KOPIOWANIa postgreSQL. |
kompresja
text specyfikacja typu kompresji. Można ustawić dowolną z następujących wartości:
| Format | Wartość domyślna | Opis |
|---|---|---|
auto |
true |
Wywnioskuje wartość na podstawie ostatniej serii znaków przypisanych do nazwy obiektu blob. Jeśli nazwa obiektu blob kończy się ciągiem .gz, przyjmuje wartość gzip. W przeciwnym razie przyjęto nonezałożenie, że . |
brotli |
Wymusza użycie algorytmu kompresji brotli w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
gzip |
Wymusza użycie algorytmu kompresji gzip w celu skompresowania obiektu blob. | |
lz4 |
Wymusza użycie algorytmu kompresji lz4 w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
none |
Wymusza kompresowanie obiektu blob. | |
snappy |
Wymusza użycie algorytmu kompresji snappy w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
zstd |
Wymusza użycie algorytmu kompresji zstd w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
Rozszerzenie nie obsługuje żadnych innych typów kompresji.
Opcje
jsonb ustawienia definiujące obsługę nagłówków niestandardowych, separatorów niestandardowych, znaków ucieczki itp. options wpływa na zachowanie tej funkcji w sposób podobny do sposobu przekazywania opcji do COPY polecenia w usłudze PostgreSQL wpływa na jego zachowanie.
Typ zwracany
SETOF record
SETOF anyelement
azure_storage.blob_put
Funkcja umożliwiająca eksportowanie danych przez przekazanie plików do kontenera obiektów blob na koncie usługi Azure Storage. Zawartość plików jest generowany z wierszy w usłudze PostgreSQL.
Uwaga / Notatka
Przed próbą uzyskania dostępu do kontenera dla określonego konta magazynu ta funkcja sprawdza, czy nazwy konta magazynu i kontenera przekazane jako argumenty są prawidłowe zgodnie z regułami walidacji nazewnictwa nałożonymi na konta usługi Azure Storage. Jeśli którykolwiek z nich jest nieprawidłowy, zostanie zgłoszony błąd.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
Istnieje przeciążona wersja funkcji zawierająca parametr, który umożliwia określenie kodera do użycia, encoder gdy nie można wywnioskować go z rozszerzenia parametru path lub gdy chcesz zastąpić ten, wywnioskowany.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
Istnieje przeciążona wersja funkcji, która zawiera compression również parametr, który pozwala określić kompresję do użycia, gdy nie można wywnioskować z rozszerzenia parametru path lub gdy chcesz zastąpić ten, wywnioskowany.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Istnieje przeciążona wersja funkcji, która zawiera options również parametr do obsługi nagłówków niestandardowych, separatorów niestandardowych, znaków ucieczki itp. options działa w podobny sposób do opcji, które można przekazać do COPY polecenia w usłudze PostgreSQL.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;
Uprawnienia
Użytkownik lub rola wywołująca tę funkcję musi zostać dodana do listy dozwolonych dla określonego account_name elementu, wykonując azure_storage.account_user_add. Członkowie programu azure_storage_admin mogą automatycznie odwoływać się do wszystkich kont usługi Azure Storage, których odwołania zostały dodane przy użyciu azure_storage.account_add.
Argumenty (w programowaniu)
account_name
text nazwa konta usługi Azure Blob Storage, które zawiera wszystkie obiekty: obiekty blob, pliki, kolejki i tabele. Konto magazynu zapewnia unikatową przestrzeń nazw dostępną z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
nazwa_kontenera
text nazwa kontenera. Kontener organizuje zestaw blobów, podobnie jak katalog w systemie plików. Konto magazynowe może zawierać nieograniczoną liczbę kontenerów, a kontener może przechowywać nieograniczoną liczbę blobów.
Nazwa kontenera musi być prawidłową nazwą systemu nazw domen (DNS), ponieważ stanowi część unikatowego identyfikatora URI używanego do adresowania kontenera lub jego obiektów blob.
Podczas nazewnictwa kontenera upewnij się, że są one zgodne z tymi regułami.
Identyfikator URI kontenera jest podobny do następującego: https://myaccount.blob.core.windows.net/mycontainer
ścieżka
text pełna nazwa obiektu blob.
krotka
record definicja struktury danych wyjściowych rekordu.
koder
text specyfikacja formatu obiektu blob. Można ustawić dowolną z następujących wartości:
| Format | Wartość domyślna | Opis |
|---|---|---|
auto |
true |
Wywnioskuje wartość na podstawie ostatniej serii znaków przypisanych do nazwy obiektu blob. Jeśli nazwa obiektu blob kończy się ciągiem .csv lub .csv.gz, przyjmuje wartość csv. Jeśli wartość kończy się ciągiem .tsv lub .tsv.gz, przyjmuje wartość tsv. Jeśli kończy się ciągiem .json, , .json.gz, .xml.xml.gz, .txtlub .txt.gz, przyjmuje wartość text. |
binary |
Format kopiowania plików binarnych PostgreSQL. | |
csv |
Format wartości rozdzielonych przecinkami używany przez narzędzie PostgreSQL COPY. | |
parquet |
Format Parquet. | |
text | xml | json |
Plik zawierający pojedynczą wartość tekstową. | |
tsv |
Wartości rozdzielane tabulatorami, domyślny format KOPIOWANIa postgreSQL. |
kompresja
text specyfikacja typu kompresji. Można ustawić dowolną z następujących wartości:
| Format | Wartość domyślna | Opis |
|---|---|---|
auto |
true |
Wywnioskuje wartość na podstawie ostatniej serii znaków przypisanych do nazwy obiektu blob. Jeśli nazwa obiektu blob kończy się ciągiem .gz, przyjmuje wartość gzip. W przeciwnym razie przyjęto nonezałożenie, że . |
brotli |
Wymusza użycie algorytmu kompresji brotli w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
gzip |
Wymusza użycie algorytmu kompresji gzip w celu skompresowania obiektu blob. | |
lz4 |
Wymusza użycie algorytmu kompresji lz4 w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
none |
Wymusza kompresowanie obiektu blob. | |
snappy |
Wymusza użycie algorytmu kompresji snappy w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
zstd |
Wymusza użycie algorytmu kompresji zstd w celu skompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
Rozszerzenie nie obsługuje żadnych innych typów kompresji.
Opcje
jsonb ustawienia definiujące obsługę nagłówków niestandardowych, separatorów niestandardowych, znaków ucieczki itp. options wpływa na zachowanie tej funkcji w sposób podobny do sposobu przekazywania opcji do COPY polecenia w usłudze PostgreSQL wpływa na jego zachowanie.
Typ zwracany
VOID
azure_storage.options_copy
Funkcja, która działa jako funkcja narzędzia, którą można wywołać jako parametr w pliku blob_get. Działa jako funkcja pomocnika dla options_parquet, options_csv_get, options_tsv i 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);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
ogranicznik
text znak oddzielający kolumny w każdym wierszu (wierszu) pliku. Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY delimiter must be a single one-byte character .
null_string
text ciąg reprezentujący wartość null. Wartość domyślna to \N (ukośnik odwrotny-N) w formacie tekstowym i pusty ciąg bez cudzysłów w formacie CSV. Możesz preferować pusty ciąg nawet w formacie tekstowym, jeśli nie chcesz odróżnić wartości null od pustych ciągów.
nagłówek
boolean flaga wskazująca, czy plik zawiera wiersz nagłówka z nazwami każdej kolumny w pliku. W danych wyjściowych początkowy wiersz zawiera nazwy kolumn z tabeli.
dane Quote
text znak cudzysłów, który ma być używany, gdy wartość danych jest cytowana. Wartość domyślna to podwójny cudzysłów. Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY quote must be a single one-byte character .
uciec
text znak, który powinien zostać wyświetlony przed znakiem danych zgodnym z wartością CUDZYSŁOWU. Wartość domyślna jest taka sama jak wartość CUDZYSŁOWU (tak aby znak cudzysłowu był podwajany, jeśli pojawia się w danych). Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY escape must be a single one-byte character .
force_quote
text[] wymusza cudzysłów, które mają być używane dla wszystkich wartości innych niż NULL w każdej określonej kolumnie. Dane wyjściowe null nigdy nie są cytowane. Jeśli wartość * jest określona, wartości inne niż NULL są cytowane we wszystkich kolumnach.
force_not_null
text[] nie dopasuj wartości określonych kolumn do ciągu o wartości null. W domyślnym przypadku, gdy ciąg null jest pusty, oznacza to, że puste wartości są odczytywane jako ciągi o zerowej długości, a nie wartości null, nawet jeśli nie są cytowane.
force_null
text[] dopasuj wartości określonych kolumn do ciągu o wartości null, nawet w przypadku cudzysłów, a jeśli zostanie znalezione dopasowanie, ustaw wartość NULL. W domyślnym przypadku, w którym ciąg null jest pusty, konwertuje ciąg pusty cudzysłów na wartość NULL.
content_encoding
text nazwa kodowania, za pomocą którego plik jest zakodowany. Jeśli opcja zostanie pominięta, zostanie użyte bieżące kodowanie klienta.
Typ zwracany
jsonb
azure_storage.options_parquet
Funkcja, która działa jako funkcja narzędzia, którą można wywołać jako parametr w pliku blob_get, i jest przydatna do dekodowania zawartości pliku parquet.
azure_storage.options_parquet();
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
Typ zwracany
jsonb
azure_storage.options_csv_get
Funkcja, która działa jako funkcja narzędzia, którą można wywołać jako parametr w pliku blob_get, i jest przydatna do dekodowania zawartości pliku 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);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
ogranicznik
text znak oddzielający kolumny w każdym wierszu (wierszu) pliku. Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY delimiter must be a single one-byte character .
null_string
text ciąg reprezentujący wartość null. Wartość domyślna to \N (ukośnik odwrotny-N) w formacie tekstowym i pusty ciąg bez cudzysłów w formacie CSV. Możesz preferować pusty ciąg nawet w formacie tekstowym, jeśli nie chcesz odróżnić wartości null od pustych ciągów.
nagłówek
boolean flaga wskazująca, czy plik zawiera wiersz nagłówka z nazwami każdej kolumny w pliku. W danych wyjściowych początkowy wiersz zawiera nazwy kolumn z tabeli.
dane Quote
text znak cudzysłów, który ma być używany, gdy wartość danych jest cytowana. Wartość domyślna to podwójny cudzysłów. Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY quote must be a single one-byte character .
uciec
text znak, który powinien zostać wyświetlony przed znakiem danych zgodnym z wartością CUDZYSŁOWU. Wartość domyślna jest taka sama jak wartość CUDZYSŁOWU (tak aby znak cudzysłowu był podwajany, jeśli pojawia się w danych). Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY escape must be a single one-byte character .
force_not_null
text[] nie dopasuj wartości określonych kolumn do ciągu o wartości null. W domyślnym przypadku, gdy ciąg null jest pusty, oznacza to, że puste wartości są odczytywane jako ciągi o zerowej długości, a nie wartości null, nawet jeśli nie są cytowane.
force_null
text[] dopasuj wartości określonych kolumn do ciągu o wartości null, nawet w przypadku cudzysłów, a jeśli zostanie znalezione dopasowanie, ustaw wartość NULL. W domyślnym przypadku, w którym ciąg null jest pusty, konwertuje ciąg pusty cudzysłów na wartość NULL.
content_encoding
text nazwa kodowania, za pomocą którego plik jest zakodowany. Jeśli opcja zostanie pominięta, zostanie użyte bieżące kodowanie klienta.
Typ zwracany
jsonb
azure_storage.options_tsv
Funkcja, która działa jako funkcja narzędzia, którą można wywołać jako parametr w pliku blob_get, i jest przydatna do dekodowania zawartości pliku tsv.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
ogranicznik
text znak oddzielający kolumny w każdym wierszu (wierszu) pliku. Musi być pojedynczym znakiem 1-bajtowym. Mimo że ta funkcja obsługuje ograniczniki dowolnej liczby znaków, jeśli spróbujesz użyć więcej niż jednego znaku 1-bajtowego, usługa PostgreSQL zgłasza błąd COPY delimiter must be a single one-byte character .
null_string
text ciąg reprezentujący wartość null. Wartość domyślna to \N (ukośnik odwrotny-N) w formacie tekstowym i pusty ciąg bez cudzysłów w formacie CSV. Możesz preferować pusty ciąg nawet w formacie tekstowym, jeśli nie chcesz odróżnić wartości null od pustych ciągów.
content_encoding
text nazwa kodowania, za pomocą którego plik jest zakodowany. Jeśli opcja zostanie pominięta, zostanie użyte bieżące kodowanie klienta.
Typ zwracany
jsonb
azure_storage.options_binary
Funkcja, która działa jako funkcja narzędzia, która może być wywoływana jako parametr w pliku blob_get, i jest przydatna do dekodowania zawartości pliku binarnego.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Uprawnienia
Każdy użytkownik lub rola może wywołać tę funkcję.
Argumenty (w programowaniu)
content_encoding
text nazwa kodowania, za pomocą którego plik jest zakodowany. Jeśli opcja zostanie pominięta, zostanie użyte bieżące kodowanie klienta.
Typ zwracany
jsonb