Referensi fungsi yang disediakan oleh ekstensi Azure Storage di Azure Database for PostgreSQL

Berikut ini adalah daftar fungsi yang disediakan oleh ekstensi Azure Storage:

azure_storage.account_add

Fungsi yang memungkinkan penambahan akun penyimpanan, dan kunci akses terkait, ke daftar akun penyimpanan yang azure_storage dapat diakses ekstensi.

Jika pemanggilan fungsi ini sebelumnya sudah menambahkan referensi ke akun penyimpanan ini, itu tidak menambahkan entri baru tetapi sebaliknya memperbarui kunci akses entri yang ada.

Nota

Fungsi ini tidak memvalidasi apakah nama akun yang dirujuk ada atau jika dapat diakses dengan kunci akses yang disediakan. Namun, ini memvalidasi bahwa nama akun penyimpanan valid, sesuai dengan aturan validasi penamaan yang diberlakukan pada akun penyimpanan Azure.

azure_storage.account_add(account_name_p text, account_key_p text);

Ada versi fungsi ini yang kelebihan beban, yang menerima account_config parameter yang merangkum nama akun Azure Storage yang direferensikan, dan semua pengaturan yang diperlukan seperti jenis autentikasi, jenis akun, atau kredensial penyimpanan.

azure_storage.account_add(account_config jsonb);

Hak akses

Harus menjadi anggota azure_storage_admin.

Argumen

account_name_p

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

account_key_p

text nilai salah satu kunci akses untuk akun penyimpanan. Kunci akses penyimpanan blob Azure Anda mirip dengan kata sandi akar untuk akun penyimpanan Anda. Selalu berhati-hatilah untuk melindungi kunci akses Anda. Gunakan Azure Key Vault untuk mengelola dan memutar kunci Anda dengan aman. Kunci akun disimpan dalam tabel yang hanya dapat diakses oleh superuser. Pengguna yang azure_storage_admin diberikan peran dapat berinteraksi dengan tabel ini melalui fungsi. Untuk melihat akun penyimpanan mana yang ditambahkan, gunakan fungsi azure_storage.account_list.

account_config

jsonb nama akun Azure Storage dan semua pengaturan yang diperlukan seperti jenis autentikasi, jenis akun, atau kredensial penyimpanan. Sebaiknya gunakan fungsi utilitas azure_storage.account_options_managed_identity, azure_storage.account_options_credentials, atau azure_storage.account_options untuk membuat salah satu nilai valid yang harus diteruskan sebagai argumen ini.

Tipe pengembalian

VOID

azure_storage.account_options_managed_identity

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat disebut sebagai parameter dalam azure_storage.account_add, dan berguna untuk menghasilkan nilai yang valid untuk account_config argumen, saat menggunakan identitas terkelola yang ditetapkan sistem untuk berinteraksi dengan akun Azure Storage.

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

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

Nama

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

jenis

azure_storage.storage_type nilai salah satu jenis penyimpanan yang didukung. Hanya nilai yang didukung adalah blob.

Tipe pengembalian

jsonb

azure_storage.account_options_credentials

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat disebut sebagai parameter dalam azure_storage.account_add, dan berguna untuk menghasilkan nilai yang valid untuk account_config argumen, saat menggunakan kunci akses Azure Storage untuk berinteraksi dengan akun Azure Storage.

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

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

Nama

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

kredensial

text nilai salah satu kunci akses untuk akun penyimpanan. Kunci akses penyimpanan blob Azure Anda mirip dengan kata sandi akar untuk akun penyimpanan Anda. Selalu berhati-hatilah untuk melindungi kunci akses Anda. Gunakan Azure Key Vault untuk mengelola dan memutar kunci Anda dengan aman. Kunci akun disimpan dalam tabel yang hanya dapat diakses oleh superuser. Pengguna yang azure_storage_admin diberikan peran dapat berinteraksi dengan tabel ini melalui fungsi. Untuk melihat akun penyimpanan mana yang ditambahkan, gunakan fungsi azure_storage.account_list.

jenis

azure_storage.storage_type nilai salah satu jenis penyimpanan yang didukung. Hanya nilai yang didukung adalah blob.

Tipe pengembalian

jsonb

azure_storage.account_options

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat dipanggil sebagai parameter dalam azure_storage.account_add, dan berguna untuk menghasilkan nilai yang valid untuk account_config argumen, saat menggunakan kunci akses Azure Storage atau identitas terkelola yang ditetapkan sistem untuk berinteraksi dengan akun Azure Storage.

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

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

Nama

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

auth_type

azure_storage.auth_type nilai salah satu jenis penyimpanan yang didukung. Hanya nilai yang didukung adalah access-key, dan managed-identity.

storage_type

azure_storage.storage_type nilai salah satu jenis penyimpanan yang didukung. Hanya nilai yang didukung adalah blob.

kredensial

text nilai salah satu kunci akses untuk akun penyimpanan. Kunci akses penyimpanan blob Azure Anda mirip dengan kata sandi akar untuk akun penyimpanan Anda. Selalu berhati-hatilah untuk melindungi kunci akses Anda. Gunakan Azure Key Vault untuk mengelola dan memutar kunci Anda dengan aman. Kunci akun disimpan dalam tabel yang hanya dapat diakses oleh superuser. Pengguna yang azure_storage_admin diberikan peran dapat berinteraksi dengan tabel ini melalui fungsi. Untuk melihat akun penyimpanan mana yang ditambahkan, gunakan fungsi azure_storage.account_list.

Tipe pengembalian

jsonb

azure_storage.account_remove

Fungsi yang memungkinkan penghapusan akun penyimpanan dan kunci akses terkait dari daftar akun penyimpanan yang azure_storage dapat diakses ekstensi.

azure_storage.account_remove(account_name_p text);

Hak akses

Harus menjadi anggota azure_storage_admin.

Argumen

account_name_p

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

Tipe pengembalian

VOID

azure_storage.account_user_add

Fungsi yang memungkinkan pemberian akses pengguna atau peran PostgreSQL ke akun penyimpanan melalui fungsi yang disediakan oleh azure_storage ekstensi.

Nota

Eksekusi fungsi ini hanya berhasil jika akun penyimpanan, yang namanya diteruskan sebagai argumen pertama, sudah dibuat menggunakan azure_storage.account_add, dan jika pengguna atau peran, yang namanya diteruskan sebagai argumen kedua, sudah ada.

azure_storage.account_add(account_name_p text, user_p regrole);

Hak akses

Harus menjadi anggota azure_storage_admin.

Argumen

account_name_p

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

user_p

regrole nama pengguna atau peran PostgreSQL yang tersedia di server.

Tipe pengembalian

VOID

azure_storage.account_user_remove

Fungsi yang memungkinkan pencabutan pengguna PostgreSQL atau akses peran ke akun penyimpanan melalui fungsi yang disediakan oleh azure_storage ekstensi.

Nota

Eksekusi fungsi ini hanya berhasil jika akun penyimpanan yang namanya sedang diteruskan karena argumen pertama telah dibuat menggunakan azure_storage.account_add, dan jika pengguna atau peran yang namanya diteruskan sebagai argumen kedua masih ada. Ketika pengguna atau peran dihilangkan dari server, dengan menjalankan DROP USER | ROLE, izin yang diberikan pada referensi apa pun ke akun Azure Storage juga secara otomatis dihilangkan.

azure_storage.account_user_remove(account_name_p text, user_p regrole);

Hak akses

Harus menjadi anggota azure_storage_admin.

Argumen

account_name_p

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

user_p

regrole nama pengguna atau peran PostgreSQL yang tersedia di server.

Tipe pengembalian

VOID

azure_storage.account_list

Fungsi yang mencantumkan nama akun penyimpanan yang dikonfigurasi melalui fungsi azure_storage.account_add , bersama dengan pengguna atau peran PostgreSQL yang diberikan izin untuk berinteraksi dengan akun penyimpanan tersebut melalui fungsi yang disediakan oleh azure_storage ekstensi.

azure_storage.account_list();

Hak akses

Harus menjadi anggota azure_storage_admin.

Argumen

Fungsi ini tidak mengambil argumen apa pun.

Tipe pengembalian

TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) tabel empat kolom dengan daftar akun Azure Storage yang ditambahkan, jenis autentikasi yang digunakan untuk berinteraksi dengan setiap akun, jenis penyimpanan, dan daftar pengguna atau peran PostgreSQL yang diberikan akses ke akun tersebut.

azure_storage.blob_list

Fungsi yang mencantumkan nama dan properti lainnya (ukuran, lastModified, eTag, contentType, contentEncoding, dan contentHash) blob yang disimpan dalam kontainer tertentu dari akun penyimpanan yang dirujuk.

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

Hak akses

Pengguna atau peran yang memanggil fungsi ini harus ditambahkan ke daftar yang diizinkan untuk yang account_name dirujuk, dengan menjalankan azure_storage.account_user_add. azure_storage_admin Anggota secara otomatis diizinkan untuk mereferensikan semua akun Azure Storage yang referensinya ditambahkan menggunakan azure_storage.account_add.

Argumen

account_name

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

nama_kontainer

text nama kontainer. Kontainer mengatur sekumpulan blob, mirip dengan direktori dalam sistem file. Akun penyimpanan dapat mencakup jumlah kontainer yang tidak terbatas, dan kontainer dapat menyimpan blob dalam jumlah tak terbatas. Nama kontainer harus berupa nama Sistem Nama Domain (DNS) yang valid, karena merupakan bagian dari URI unik yang digunakan untuk mengatasi kontainer atau blobnya. Saat menamai kontainer, pastikan untuk mengikuti aturan ini.

URI untuk kontainer mirip dengan: https://myaccount.blob.core.windows.net/mycontainer

awalan

text ketika ditentukan, fungsi mengembalikan blob yang namanya dimulai dengan nilai yang disediakan dalam parameter ini. Default ke string kosong.

Tipe pengembalian

TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) tabel dengan satu rekaman per blob yang dikembalikan, termasuk nama lengkap blob, dan beberapa properti lainnya.

jalan

text nama lengkap blob.

Byte

bigint ukuran blob dalam byte.

last_modified

timestamp with time zonetanggal dan waktu blob terakhir diubah. Setiap operasi yang memodifikasi blob, termasuk pembaruan metadata atau properti blob, mengubah waktu blob yang terakhir dimodifikasi.

etag

text properti ETag digunakan untuk konkurensi optimis selama pembaruan. Ini bukan tanda waktu karena ada properti lain yang disebut Tanda Waktu yang menyimpan terakhir kali rekaman diperbarui. Misalnya, jika Anda memuat entitas dan ingin memperbaruinya, ETag harus cocok dengan apa yang saat ini disimpan. Mengatur ETag yang sesuai penting karena jika Anda memiliki beberapa pengguna yang mengedit item yang sama, Anda tidak ingin mereka menimpa perubahan satu sama lain.

content_type

text tipe konten yang ditentukan untuk blob. Jenis konten default adalah application/octet-stream.

content_encoding

text properti Pengodean Konten dari blob yang memungkinkan Anda menentukan Azure Storage. Untuk konten terkompresi, Anda dapat mengatur properti menjadi Gzip. Saat browser mengakses konten, browser secara otomatis mendekompresi konten.

content_hash

text hash yang digunakan untuk memverifikasi integritas blob selama transportasi. Ketika header ini ditentukan, layanan penyimpanan memeriksa hash yang disediakan dengan satu yang dihitung dari konten. Jika kedua hash tidak cocok, operasi gagal dengan kode kesalahan 400 (Permintaan Buruk).

azure_storage.blob_get

Fungsi yang memungkinkan impor data. Ini mengunduh file dari kontainer blob di akun Azure Storage. Kemudian menerjemahkan konten ke dalam baris, yang dapat dikonsumsi dan diproses dengan konstruksi bahasa SQL. Fungsi ini menambahkan dukungan untuk memfilter dan memanipulasi data yang diambil dari kontainer blob sebelum mengimpornya.

Nota

Sebelum mencoba mengakses kontainer untuk akun penyimpanan yang dirujuk, fungsi ini memeriksa apakah nama akun penyimpanan dan kontainer yang diteruskan sebagai argumen valid sesuai dengan aturan validasi penamaan yang diberlakukan pada akun penyimpanan Azure. Jika salah satunya tidak valid, kesalahan akan muncul.

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

Ada versi fungsi ini yang kelebihan beban, yang menerima rec parameter yang memungkinkan Anda menentukan rekaman format output dengan mudah.

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

Hak akses

Pengguna atau peran yang memanggil fungsi ini harus ditambahkan ke daftar yang diizinkan untuk yang account_name dirujuk, dengan menjalankan azure_storage.account_user_add. azure_storage_admin Anggota secara otomatis diizinkan untuk mereferensikan semua akun Azure Storage yang referensinya ditambahkan menggunakan azure_storage.account_add.

Argumen

account_name

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

nama_kontainer

text nama kontainer. Kontainer mengatur sekumpulan blob, mirip dengan direktori dalam sistem file. Akun penyimpanan dapat mencakup jumlah kontainer yang tidak terbatas, dan kontainer dapat menyimpan blob dalam jumlah tak terbatas. Nama kontainer harus berupa nama Sistem Nama Domain (DNS) yang valid, karena merupakan bagian dari URI unik yang digunakan untuk mengatasi kontainer atau blobnya. Saat menamai kontainer, pastikan untuk mengikuti aturan ini.

URI untuk kontainer mirip dengan: https://myaccount.blob.core.windows.net/mycontainer

jalan

text nama lengkap blob.

Rec

anyelement definisi struktur output rekaman.

Decoder

text spesifikasi format blob. Dapat diatur ke salah satu nilai berikut:

Format	Default	Deskripsi
auto	true	Menyimpulkan nilai berdasarkan seri terakhir karakter yang ditetapkan ke nama blob. Jika nama blob berakhir dengan .parquet, itu mengasumsikan parquet. Jika diakhir dengan .csv atau .csv.gz, itu mengasumsikan csv. Jika diakhir dengan .tsv atau .tsv.gz, itu mengasumsikan tsv. Jika diakhir dengan .json, , .json.gz.xml, .xml.gz, .txt, atau .txt.gz, diasumsikan text.
binary		Format SALINAN PostgreSQL Biner.
csv		Format nilai yang dipisahkan koma yang digunakan oleh PostgreSQL COPY.
parquet		Format parquet.
text | xml | json		File yang berisi satu nilai teks.
tsv		Nilai yang dipisahkan tab, format SALIN PostgreSQL default.

pemadatan

text spesifikasi jenis kompresi. Dapat diatur ke salah satu nilai berikut:

Format	Default	Deskripsi
auto	true	Menyimpulkan nilai berdasarkan seri terakhir karakter yang ditetapkan ke nama blob. Jika nama blob berakhir dengan .gz, itu mengasumsikan gzip. Jika tidak, ia mengasumsikan none.
brotli		Memaksa menggunakan algoritma kompresi brotli untuk mengompresi blob. Hanya didukung oleh parquet encoder.
gzip		Memaksa menggunakan algoritma kompresi gzip untuk mengompresi blob.
lz4		Memaksa menggunakan algoritma kompresi lz4 untuk mengompresi blob. Hanya didukung oleh parquet encoder.
none		Memaksa untuk tidak mengompresi blob.
snappy		Memaksa menggunakan algoritma kompresi snappy untuk mengompresi blob. Hanya didukung oleh parquet encoder.
zstd		Memaksa menggunakan algoritma kompresi zstd untuk mengompresi blob. Hanya didukung oleh parquet encoder.

Ekstensi tidak mendukung jenis kompresi lainnya.

opsi

jsonb pengaturan yang menentukan penanganan header kustom, pemisah kustom, karakter escape, dll. options mempengaruhi perilaku fungsi ini dengan cara yang mirip dengan bagaimana opsi yang dapat Anda teruskan ke COPY perintah di PostgreSQL memengaruhi perilakunya.

Tipe pengembalian

SETOF record SETOF anyelement

azure_storage.blob_put

Fungsi yang memungkinkan ekspor data, dengan mengunggah file ke kontainer blob di akun Azure Storage. Konten file diproduksi dari baris di PostgreSQL.

Nota

Sebelum mencoba mengakses kontainer untuk akun penyimpanan yang dirujuk, fungsi ini memeriksa apakah nama akun penyimpanan dan kontainer yang diteruskan sebagai argumen valid sesuai dengan aturan validasi penamaan yang diberlakukan pada akun penyimpanan Azure. Jika salah satunya tidak valid, kesalahan akan muncul.

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

Ada versi fungsi yang kelebihan beban, berisi encoder parameter yang memungkinkan Anda menentukan encoder untuk digunakan ketika tidak dapat disimpulkan dari ekstensi path parameter, atau ketika Anda ingin mengambil alih yang disimpulkan.

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

Ada versi fungsi yang kelebihan beban yang juga berisi compression parameter yang memungkinkan Anda menentukan kompresi yang akan digunakan ketika tidak dapat disimpulkan dari ekstensi path parameter, atau ketika Anda ingin mengambil alih yang disimpulkan.

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

Ada versi fungsi yang kelebihan beban yang juga berisi options parameter untuk menangani header kustom, pemisah kustom, karakter escape, dll. options bekerja dengan cara yang sama dengan opsi yang dapat diteruskan ke COPY perintah di PostgreSQL.

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

Hak akses

Pengguna atau peran yang memanggil fungsi ini harus ditambahkan ke daftar yang diizinkan untuk yang account_name dirujuk, dengan menjalankan azure_storage.account_user_add. azure_storage_admin Anggota secara otomatis diizinkan untuk mereferensikan semua akun Azure Storage yang referensinya ditambahkan menggunakan azure_storage.account_add.

Argumen

account_name

text nama akun penyimpanan blob Azure yang berisi semua objek Anda: blob, file, antrean, dan tabel. Akun penyimpanan menyediakan namespace unik yang dapat diakses dari mana saja di seluruh dunia melalui HTTPS.

nama_kontainer

text nama kontainer. Kontainer mengatur sekumpulan blob, mirip dengan direktori dalam sistem file. Akun penyimpanan dapat mencakup jumlah kontainer yang tidak terbatas, dan kontainer dapat menyimpan blob dalam jumlah tak terbatas. Nama kontainer harus berupa nama Sistem Nama Domain (DNS) yang valid, karena merupakan bagian dari URI unik yang digunakan untuk mengatasi kontainer atau blobnya. Saat menamai kontainer, pastikan untuk mengikuti aturan ini.

URI untuk kontainer mirip dengan: https://myaccount.blob.core.windows.net/mycontainer

jalan

text nama lengkap blob.

tupel

record definisi struktur output rekaman.

Encoder

text spesifikasi format blob. Dapat diatur ke salah satu nilai berikut:

Format	Default	Deskripsi
auto	true	Menyimpulkan nilai berdasarkan seri terakhir karakter yang ditetapkan ke nama blob. Jika nama blob berakhir dengan .csv atau .csv.gz, itu mengasumsikan csv. Jika diakhir dengan .tsv atau .tsv.gz, itu mengasumsikan tsv. Jika diakhir dengan .json, , .json.gz.xml, .xml.gz, .txt, atau .txt.gz, diasumsikan text.
binary		Format SALINAN PostgreSQL Biner.
csv		Format nilai yang dipisahkan koma yang digunakan oleh PostgreSQL COPY.
parquet		Format parquet.
text | xml | json		File yang berisi satu nilai teks.
tsv		Nilai yang dipisahkan tab, format SALIN PostgreSQL default.

pemadatan

text spesifikasi jenis kompresi. Dapat diatur ke salah satu nilai berikut:

Format	Default	Deskripsi
auto	true	Menyimpulkan nilai berdasarkan seri terakhir karakter yang ditetapkan ke nama blob. Jika nama blob berakhir dengan .gz, itu mengasumsikan gzip. Jika tidak, ia mengasumsikan none.
brotli		Memaksa menggunakan algoritma kompresi brotli untuk mengompresi blob. Hanya didukung oleh parquet encoder.
gzip		Memaksa menggunakan algoritma kompresi gzip untuk mengompresi blob.
lz4		Memaksa menggunakan algoritma kompresi lz4 untuk mengompresi blob. Hanya didukung oleh parquet encoder.
none		Memaksa untuk tidak mengompresi blob.
snappy		Memaksa menggunakan algoritma kompresi snappy untuk mengompresi blob. Hanya didukung oleh parquet encoder.
zstd		Memaksa menggunakan algoritma kompresi zstd untuk mengompresi blob. Hanya didukung oleh parquet encoder.

Ekstensi tidak mendukung jenis kompresi lainnya.

opsi

jsonb pengaturan yang menentukan penanganan header kustom, pemisah kustom, karakter escape, dll. options mempengaruhi perilaku fungsi ini dengan cara yang mirip dengan bagaimana opsi yang dapat Anda teruskan ke COPY perintah di PostgreSQL memengaruhi perilakunya.

Tipe pengembalian

VOID

azure_storage.options_copy

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat disebut sebagai parameter dalam blob_get. Ini bertindak sebagai fungsi pembantu untuk options_parquet, options_csv_get, options_tsv, dan 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);

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

pemisah

text karakter yang memisahkan kolom dalam setiap baris (baris) file. Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY delimiter must be a single one-byte character kesalahan.

null_string

text string yang mewakili nilai null. Defaultnya adalah \N (backslash-N) dalam format teks, dan string kosong yang tidak dikutip dalam format CSV. Anda mungkin lebih suka string kosong bahkan dalam format teks untuk kasus di mana Anda tidak ingin membedakan null dari string kosong.

header

boolean bendera yang menunjukkan apakah file berisi baris header dengan nama setiap kolom dalam file. Pada output, baris awal berisi nama kolom dari tabel.

kuotasi

text karakter kutipan yang akan digunakan saat nilai data dikutip. Defaultnya adalah tanda kutip ganda. Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY quote must be a single one-byte character kesalahan.

melarikan diri

text karakter yang akan muncul sebelum karakter data yang cocok dengan nilai QUOTE. Defaultnya sama dengan nilai QUOTE (sehingga karakter kutipan digandakan jika muncul dalam data). Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY escape must be a single one-byte character kesalahan.

force_quote

text[] memaksa kutipan untuk digunakan untuk semua nilai non-NULL di setiap kolom yang ditentukan. Output NULL tidak pernah dikutip. Jika * ditentukan, nilai non-NULL dikutip di semua kolom.

force_not_null

text[] tidak cocok dengan nilai kolom yang ditentukan dengan string null. Dalam kasus default di mana string null kosong, itu berarti bahwa nilai kosong dibaca sebagai string panjang nol daripada null, bahkan ketika tidak dikutip.

force_null

text[] cocokkan nilai kolom yang ditentukan dengan string null, bahkan jika dikutip, dan jika kecocokan ditemukan, atur nilai ke NULL. Dalam kasus default di mana string null kosong, string tersebut mengonversi string kosong yang dikutip menjadi NULL.

content_encoding

text nama pengodean yang filenya dikodekan. Jika opsi dihilangkan, pengodean klien saat ini digunakan.

Tipe pengembalian

jsonb

azure_storage.options_parquet

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat dipanggil sebagai parameter dalam blob_get, dan berguna untuk mendekode konten file parkek.

azure_storage.options_parquet();

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

Tipe pengembalian

jsonb

azure_storage.options_csv_get

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat disebut sebagai parameter dalam blob_get, dan berguna untuk mendekode konten file 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);

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

pemisah

text karakter yang memisahkan kolom dalam setiap baris (baris) file. Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY delimiter must be a single one-byte character kesalahan.

null_string

text string yang mewakili nilai null. Defaultnya adalah \N (backslash-N) dalam format teks, dan string kosong yang tidak dikutip dalam format CSV. Anda mungkin lebih suka string kosong bahkan dalam format teks untuk kasus di mana Anda tidak ingin membedakan null dari string kosong.

header

boolean bendera yang menunjukkan apakah file berisi baris header dengan nama setiap kolom dalam file. Pada output, baris awal berisi nama kolom dari tabel.

kuotasi

text karakter kutipan yang akan digunakan saat nilai data dikutip. Defaultnya adalah tanda kutip ganda. Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY quote must be a single one-byte character kesalahan.

melarikan diri

text karakter yang akan muncul sebelum karakter data yang cocok dengan nilai QUOTE. Defaultnya sama dengan nilai QUOTE (sehingga karakter kutipan digandakan jika muncul dalam data). Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY escape must be a single one-byte character kesalahan.

force_not_null

text[] tidak cocok dengan nilai kolom yang ditentukan dengan string null. Dalam kasus default di mana string null kosong, itu berarti bahwa nilai kosong dibaca sebagai string panjang nol daripada null, bahkan ketika tidak dikutip.

force_null

text[] cocokkan nilai kolom yang ditentukan dengan string null, bahkan jika dikutip, dan jika kecocokan ditemukan, atur nilai ke NULL. Dalam kasus default di mana string null kosong, string tersebut mengonversi string kosong yang dikutip menjadi NULL.

content_encoding

text nama pengodean yang filenya dikodekan. Jika opsi dihilangkan, pengodean klien saat ini digunakan.

Tipe pengembalian

jsonb

azure_storage.options_tsv

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat disebut sebagai parameter dalam blob_get, dan berguna untuk mendekode konten file tsv.

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

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

pemisah

text karakter yang memisahkan kolom dalam setiap baris (baris) file. Ini harus berupa karakter 1-byte tunggal. Meskipun fungsi ini mendukung pemisah sejumlah karakter, jika Anda mencoba menggunakan lebih dari satu karakter 1-byte, PostgreSQL melaporkan kembali COPY delimiter must be a single one-byte character kesalahan.

null_string

text string yang mewakili nilai null. Defaultnya adalah \N (backslash-N) dalam format teks, dan string kosong yang tidak dikutip dalam format CSV. Anda mungkin lebih suka string kosong bahkan dalam format teks untuk kasus di mana Anda tidak ingin membedakan null dari string kosong.

content_encoding

text nama pengodean yang filenya dikodekan. Jika opsi dihilangkan, pengodean klien saat ini digunakan.

Tipe pengembalian

jsonb

azure_storage.options_binary

Fungsi yang bertindak sebagai fungsi utilitas, yang dapat disebut sebagai parameter dalam blob_get, dan berguna untuk mendekode konten file biner.

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

Hak akses

Setiap pengguna atau peran dapat memanggil fungsi ini.

Argumen

content_encoding

text nama pengodean yang filenya dikodekan. Jika opsi dihilangkan, pengodean klien saat ini digunakan.

Tipe pengembalian

jsonb

Konten terkait

• Ekstensi Azure Storage.
• Konfigurasikan ekstensi Azure Storage.
• Contoh mulai cepat.
• Memecahkan masalah kesalahan.
• Ekstensi dan modul.