Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Na poniższej liście przedstawiono funkcje udostępniane przez rozszerzenie Azure Storage:
azure_storage.account_add
Funkcja, która dodaje konto magazynu i skojarzony z nim klucz 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);
Przeciążona wersja tej funkcji akceptuje parametr, który hermetyzuje account_config nazwę przywoływanego konta Azure Storage oraz wszystkie wymagane ustawienia, takie jak typ uwierzytelniania, typ konta lub poświadczenia magazynu.
azure_storage.account_add(account_config jsonb);
Permissions
Musi być członkiem .azure_storage_admin
Arguments
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, do której można uzyskać dostęp 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, do którego może uzyskać dostęp tylko superużytkownik. 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. Użyj funkcji narzędziowych azure_storage.account_options_managed_identity, azure_storage.account_options_credentials lub azure_storage.account_options , aby utworzyć dowolne z prawidłowych wartości, które należy przekazać jako ten argument.
Typ zwracany
VOID
azure_storage.account_encrypt_existing_credentials
Funkcja, która skanuje listę istniejących kont magazynu dodanych przy użyciu azure_storage.account_add w starszych wersjach rozszerzenia. Te wersje przechowują niezaszyfrowane poświadczenia. Ta funkcja szyfruje wszystkie poświadczenia przy użyciu klucza przechowywanego w pliku azure_storage.credential_encryption_key. Wartość parametru azure_storage.credential_encryption_key jest ograniczona na poziomie serwera. W związku z tym, jeśli utworzysz rozszerzenie Azure Storage w wielu bazach danych na tym samym serwerze, ten sam klucz szyfrowania szyfruje wszystkie poufne poświadczenia przechowywane przez rozszerzenie, niezależnie od bazy danych, w której są przechowywane.
Ważna
Jeśli tworzysz rozszerzenie Azure Storage w wielu bazach danych tego samego serwera, musisz wykonać azure_storage.account_encrypt_existing_credentials funkcję w każdej z tych baz danych.
azure_storage.account_encrypt_existing_credentials();
Permissions
Musi być członkiem .azure_storage_admin
Arguments
Ta funkcja nie bierze żadnych argumentów.
Typ zwracany
bigint Liczba istniejących poświadczeń konta magazynu, które zostały niezaszyfrowane przed wykonaniem funkcji i są teraz szyfrowane przy użyciu klucza przechowywanego w azure_storage.credential_encryption_keyprogramie .
azure_storage.account_options_managed_identity
Funkcja, która działa jako funkcja narzędziowa. Wywołaj go jako parametr w pliku azure_storage.account_add. Ułatwia utworzenie prawidłowej wartości argumentu account_config w przypadku korzystania z tożsamości zarządzanej przypisanej przez system do interakcji z kontem Azure Storage.
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
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, do której można uzyskać dostęp z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
typ
azure_storage.storage_type wartość jednego z obsługiwanych typów magazynu. Obsługiwana wartość to blob.
Typ zwracany
jsonb
azure_storage.account_options_credentials
Funkcja narzędzia, którą można wywołać jako parametr w pliku azure_storage.account_add. Ułatwia utworzenie prawidłowej wartości argumentu account_config podczas korzystania z klucza dostępu Azure Storage do interakcji z kontem Azure Storage.
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
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, do której można uzyskać dostęp 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, do którego może uzyskać dostęp tylko superużytkownik. 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. Obsługiwana wartość to blob.
Typ zwracany
jsonb
azure_storage.account_options
Funkcja narzędzia, którą można wywołać jako parametr w pliku azure_storage.account_add. Ułatwia utworzenie prawidłowej wartości argumentu account_config podczas korzystania z klucza dostępu Azure Storage lub przypisanej przez system tożsamości zarządzanej do interakcji z kontem Azure Storage.
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
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, do której można uzyskać dostęp 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 wartości to access-key i managed-identity.
storage_type
azure_storage.storage_type wartość jednego z obsługiwanych typów magazynu. 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, do którego może uzyskać dostęp tylko superużytkownik. 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 usuwa konto magazynu i skojarzony z nim klucz 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);
Permissions
Musi być członkiem .azure_storage_admin
Arguments
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, do której można uzyskać dostęp z dowolnego miejsca na świecie za pośrednictwem protokołu HTTPS.
Typ zwracany
VOID
azure_storage.account_user_add
Funkcja, która udziela 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 została przekazana 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);
Permissions
Musi być członkiem .azure_storage_admin
Arguments
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, do której można uzyskać dostęp 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 odwołuje dostęp użytkownika lub roli PostgreSQL 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 została przekazana jako pierwszy argument już istnieje i została utworzona przy użyciu azure_storage.account_add. Użytkownik lub rola, której nazwa jest przekazywana jako drugi argument, musi również istnieć.
Po usunięciu użytkownika lub roli z serwera przez wykonanie DROP USER | ROLEpolecenia uprawnienia, które zostały przyznane w dowolnym odwołaniu do kont Azure Storage, również zostaną automatycznie usunięte.
azure_storage.account_user_remove(account_name_p text, user_p regrole);
Permissions
Musi być członkiem .azure_storage_admin
Arguments
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, do której można uzyskać dostęp 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óre mają uprawnienia do interakcji z tym kontem magazynu za pośrednictwem funkcji udostępnianych przez azure_storage rozszerzenie.
azure_storage.account_list();
Permissions
Musi być członkiem .azure_storage_admin
Arguments
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[])tabela z czterema kolumnami z listą dodanych kont Azure Storage, typem uwierzytelniania używanego do interakcji z poszczególnymi kontami, typem magazynu oraz listą użytkowników lub ról PostgreSQL, którzy mają do niej dostęp.
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);
Permissions
Dodaj użytkownika lub rolę, która wywołuje tę funkcję, do listy dozwolonych, account_name wykonując polecenie azure_storage.account_user_add. Członkowie programu azure_storage_admin mogą automatycznie odwoływać się do wszystkich kont Azure Storage, których odwołania zostały dodane przy użyciu polecenia azure_storage.account_add.
Arguments
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, do której można uzyskać dostęp 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 postępuj zgodnie z tymi regułami.
Identyfikator URI kontenera jest podobny do następującego: https://myaccount.blob.core.windows.net/mycontainer
prefix
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.
bytes
bigint rozmiar obiektu blob w bajtach.
last_modified
timestamp with time zone data 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.
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 względem określonego, który oblicza z zawartości. Jeśli dwa skróty nie są zgodne, operacja kończy się niepowodzeniem i zwraca kod błędu 400 (Nieprawidłowe żądanie).
azure_storage.blob_get
Funkcja, która importuje dane, pobierając plik z kontenera obiektów blob na koncie Azure Storage. Tłumaczy on zawartość na wiersze, których można używać i przetwarzać 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 przekazywane jako argumenty są prawidłowe zgodnie z regułami walidacji nazewnictwa nałożonymi na konta magazynu Azure. Jeśli nazwa jest nieprawidłowa, funkcja zwraca 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);
Przeciążona wersja tej funkcji akceptuje rec parametr, którego można użyć do wygodnego definiowania rekordu formatu danych wyjściowych.
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);
Permissions
Dodaj użytkownika lub rolę, która wywołuje tę funkcję, do listy dozwolonych, account_name wykonując polecenie azure_storage.account_user_add. Członkowie programu azure_storage_admin mogą automatycznie odwoływać się do wszystkich kont Azure Storage, których odwołania zostały dodane przy użyciu polecenia azure_storage.account_add.
Arguments
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, do której można uzyskać dostęp 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 postępuj zgodnie 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. Ustaw na 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. Ustaw na 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 |
Używa algorytmu kompresji brotli do kompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
gzip |
Wymusza użycie algorytmu kompresji gzip w celu skompresowania obiektu blob. | |
lz4 |
Używa algorytmu kompresji lz4 do kompresowania obiektu blob. Koder parquet jest jedynym koderem obsługującym ten algorytm. |
|
none |
Nie kompresuje obiektu blob. | |
snappy |
Używa algorytmu kompresji snappy do kompresowania obiektu blob. Koder parquet jest jedynym koderem obsługującym ten algorytm. |
|
zstd |
Używa algorytmu kompresji zstd do kompresowania obiektu blob. Koder parquet jest jedynym koderem obsługującym ten algorytm. |
Rozszerzenie nie obsługuje żadnych innych typów kompresji.
options
jsonb ustawienia definiujące obsługę nagłówków niestandardowych, separatorów niestandardowych, znaków ucieczki i innych opcji.
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, która eksportuje dane, przekazując pliki do kontenera obiektów blob na koncie Azure Storage. Funkcja tworzy zawartość pliku na podstawie 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 przekazywane jako argumenty są prawidłowe zgodnie z regułami walidacji nazewnictwa nałożonymi na konta magazynu Azure. Jeśli nazwa jest nieprawidłowa, funkcja zwraca błąd.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
Przeciążona wersja funkcji zawiera encoder parametr . Użyj tego parametru, aby określić koder, gdy nie można go wywnioskować z rozszerzenia parametru path lub gdy chcesz zastąpić wnioskowany koder.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
Przeciążona wersja funkcji zawiera compression parametr . Użyj tego parametru, aby określić kompresję, gdy nie można wywnioskować jej z rozszerzenia parametru path lub gdy chcesz zastąpić wnioskowaną kompresję.
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
Przeciążona wersja funkcji zawiera options parametr do obsługi nagłówków niestandardowych, separatorów niestandardowych, znaków ucieczki i innych opcji. Parametr 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;
Permissions
Dodaj użytkownika lub rolę, która wywołuje tę funkcję, do listy dozwolonych, account_name wykonując polecenie azure_storage.account_user_add. Członkowie programu azure_storage_admin mogą automatycznie odwoływać się do wszystkich kont Azure Storage, których odwołania zostały dodane przy użyciu polecenia azure_storage.account_add.
Arguments
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, do której można uzyskać dostęp 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 postępuj zgodnie 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. Ustaw na 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 kończy się ciągiem .tsv lub .tsv.gz, przyjmuje wartość tsv. Jeśli kończy się .jsonna , , .json.gz, .xml.gz.xml, .txt, lub .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. Ustaw na 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 |
Używa algorytmu kompresji brotli do kompresowania obiektu blob. Obsługiwane tylko przez parquet koder. |
|
gzip |
Wymusza użycie algorytmu kompresji gzip w celu skompresowania obiektu blob. | |
lz4 |
Używa algorytmu kompresji lz4 do kompresowania obiektu blob. Koder parquet jest jedynym koderem obsługującym ten algorytm. |
|
none |
Nie kompresuje obiektu blob. | |
snappy |
Używa algorytmu kompresji snappy do kompresowania obiektu blob. Koder parquet jest jedynym koderem obsługującym ten algorytm. |
|
zstd |
Używa algorytmu kompresji zstd do kompresowania obiektu blob. Koder parquet jest jedynym koderem obsługującym ten algorytm. |
Rozszerzenie nie obsługuje żadnych innych typów kompresji.
options
jsonb ustawienia definiujące obsługę nagłówków niestandardowych, separatorów niestandardowych, znaków ucieczki i innych opcji.
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 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);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
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, funkcja PostgreSQL zwraca COPY delimiter must be a single one-byte character błąd.
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, funkcja PostgreSQL zwraca COPY quote must be a single one-byte character błąd.
uciec
text Znak, który powinien pojawić się 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, funkcja PostgreSQL zwraca COPY escape must be a single one-byte character błąd.
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 jeśli podano cudzysłów. 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 pominiesz tę opcję, używane jest bieżące kodowanie klienta.
Typ zwracany
jsonb
azure_storage.options_parquet
Funkcja narzędzia dekodowania zawartości pliku Parquet. Użyj go jako parametru w pliku blob_get.
azure_storage.options_parquet();
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
Typ zwracany
jsonb
azure_storage.options_csv_get
Funkcja narzędzia do dekodowania zawartości pliku CSV. Wywołaj tę funkcję jako parametr w pliku blob_get.
azure_storage.options_csv_get(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
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, funkcja PostgreSQL zwraca COPY delimiter must be a single one-byte character błąd.
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, funkcja PostgreSQL zwraca COPY quote must be a single one-byte character błąd.
uciec
text Znak, który powinien pojawić się 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, funkcja PostgreSQL zwraca COPY escape must be a single one-byte character błąd.
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 jeśli podano cudzysłów. 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 pominiesz tę opcję, używane jest bieżące kodowanie klienta.
Typ zwracany
jsonb
azure_storage.options_tsv
Funkcja narzędzia do dekodowania zawartości pliku TSV. Wywołaj tę funkcję jako parametr w pliku blob_get.
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
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, funkcja PostgreSQL zwraca COPY delimiter must be a single one-byte character błąd.
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 pominiesz tę opcję, używane jest bieżące kodowanie klienta.
Typ zwracany
jsonb
azure_storage.options_binary
Funkcja narzędzia, którą można wywołać jako parametr w pliku blob_get. Ułatwia dekodowanie zawartości pliku binarnego.
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
Permissions
Każdy użytkownik lub rola może wywołać tę funkcję.
Arguments
content_encoding
text Nazwa kodowania, za pomocą którego plik jest zakodowany. Jeśli pominiesz tę opcję, używane jest bieżące kodowanie klienta.
Typ zwracany
jsonb