Mengonfigurasi ekstensi Azure Storage di Azure Database for PostgreSQL

Anda harus mengikuti langkah-langkah ini agar dapat menggunakan ekstensi Azure Storage:

1. Mengidentifikasi akun Azure Storage
2. Pilih jenis otorisasi
3. Memuat pustaka ekstensi
4. Izinkan daftar ekstensi
5. Membuat ekstensi
6. Menggunakan ekstensi untuk mengimpor dan mengekspor data

Mengidentifikasi akun Azure Storage

Identifikasi akun Azure Storage tempat Anda ingin pengguna ekstensi berinteraksi, untuk mengimpor data dari atau mengekspor data.

Pilih jenis otorisasi

Tentukan jenis otorisasi mana yang ingin Anda gunakan untuk permintaan yang dibuat terhadap layanan blob masing-masing akun Azure Storage tersebut. azure_storage ekstensi mendukung otorisasi dengan Kunci Bersama, dan otorisasi dengan ID Microsoft Entra.

Dari kedua jenis otorisasi ini, MICROSOFT Entra ID menyediakan keamanan yang unggul dan kemudahan penggunaan melalui Kunci Bersama, dan merupakan salah satu yang direkomendasikan Microsoft.

Untuk memenuhi prasyarat yang diperlukan dalam setiap kasus, ikuti instruksi di bagian yang sesuai:

• Otorisasi dengan ID Microsoft Entra, atau
• Otorisasi dengan Kunci Bersama.

Untuk menggunakan otorisasi dengan ID Microsoft Entra

1. Aktifkan Identitas Terkelola yang Ditetapkan Sistem pada instans server fleksibel Azure Database for PostgreSQL Anda.
2. Mulai ulang instans server fleksibel Azure Database for PostgreSQL, setelah mengaktifkan sistem yang ditetapkan identitas terkelola di dalamnya.
3. Tetapkan izin kontrol akses berbasis peran (RBAC) untuk akses ke data blob, pada akun Azure Storage, ke Identitas Terkelola yang Ditetapkan Sistem dari instans Server fleksibel Azure Database for PostgreSQL Anda.

Aktifkan Identitas Terkelola yang Ditetapkan Sistem

Portal Microsoft Azure

CLI

az rest \
  --method patch \
  --url https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<flexible_server_resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<flexible_server_name>?api-version=2024-08-01 \
  --body '{"identity":{"type":"SystemAssigned"}}'

REST API

Menggunakan Server - Perbarui REST API.

Untuk menggunakan otorisasi dengan Kunci Bersama

1. Konfirmasikan bahwa akun penyimpanan mengizinkan akses ke kuncinya
2. Ambil salah satu dari dua kunci akses akun penyimpanan

Konfirmasikan bahwa akun penyimpanan mengizinkan akses ke kuncinya

Akun Azure Storage Anda harus mengaktifkan Izinkan akses kunci akun penyimpanan (artinya, properti AllowSharedKeyAccess-nya tidak dapat diatur ke false).

Portal Microsoft Azure

CLI

az storage account update \
  --resource-group <storage_account_resource_group> \
  --name <account_name> \
  --allow-shared-key-access true

REST API

Menggunakan Akun Penyimpanan - Perbarui REST API.

Ambil salah satu dari dua kunci akses akun penyimpanan

Untuk meneruskannya ke fungsi azure_storage.account_add , ambil salah satu dari dua kunci akses akun Azure Storage.

Portal Microsoft Azure

CLI

az storage account keys list \
  --resource-group <storage_account_resource_group> \
  --account-name <account_name> \
  --query [0].value \
  --output tsv

REST API

Menggunakan Akun Penyimpanan - Daftar Kunci REST API.

Memuat pustaka ekstensi

Konfigurasikan server Anda sehingga memuat azure_storage modul biner saat dimulai.

Portal Microsoft Azure

shared_preload_libraries Karena bersifat statis, server harus dimulai ulang agar perubahan diterapkan:

CLI

az postgres flexible-server parameter set \
  --resource-group <resource_group> 
  --server-name <server> 
  --name shared_preload_libraries \
  --source user-override \
  --value azure_storage,$(az postgres flexible-server parameter show \
                            --resource-group <resource_group> \
                            --server-name <server> \
                            --name shared_preload_libraries \
                            --query value \
                            --output tsv)

shared_preload_libraries Karena bersifat statis, server harus dimulai ulang agar perubahan diterapkan:

az postgres flexible-server restart \
  --resource-group <resource_group> \
  --name <server>

REST API

Menggunakan Konfigurasi - Letakkan REST API.

shared_preload_libraries Karena statis, server harus dimulai ulang agar perubahan diterapkan. Untuk menghidupkan ulang server, Anda dapat menggunakan Server - Restart REST API.

Izinkan daftar ekstensi

Anda harus mengizinkan daftar ekstensi sehingga pengguna dapat menjalankan CREATE EXTENSION, DROP EXTENSION, ALTER EXTENSION, COMMENT ON EXTENSION.

Portal Microsoft Azure

CLI

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name azure.extensions \
  --source user-override \
  --value azure_storage,$(az postgres flexible-server parameter show \
                            --resource-group <resource_group> 
                            --server-name <server> \
                            --name azure.extensions \
                            --query value \
                            --output tsv)

REST API

Menggunakan Konfigurasi - Letakkan REST API.

Membuat ekstensi

Gunakan klien preferensi Anda, seperti PostgreSQL untuk Visual Studio Code (Pratinjau), psql, atau PgAdmin, untuk menyambungkan ke database tempat Anda ingin menggunakan ekstensi Azure Storage.

Untuk membuat semua objek SQL (tabel, jenis, fungsi, tampilan, dll.) tempat Anda dapat menggunakan azure_storage ekstensi untuk berinteraksi dengan instans akun Azure Storage, jalankan pernyataan berikut:

CREATE EXTENSION azure_storage;

Menggunakan ekstensi untuk mengimpor dan mengekspor data

Sekarang Anda siap untuk menambahkan akun penyimpanan yang ingin Anda berinteraksi (menggunakan azure_storage.account_add fungsi ). Kemudian Anda dapat mengimpor data yang disimpan dalam file di akun Azure Storage, dengan menggunakan azure_storage.blob_get fungsi atau COPY FROM pernyataan, atau Anda dapat mengekspor data dari PostgreSQL ke dalam file di akun Azure Storage, dengan menggunakan azure_storage.blob_put fungsi atau COPY TO pernyataan .

Lihat daftar contoh mulai cepat:

• Membuat akun Azure Storage dan mengisinya dengan data
• Membuat tabel tempat data dimuat
• Menambahkan kunci akses akun penyimpanan
• Memberikan akses ke pengguna atau peran pada referensi penyimpanan Azure Blob
• Mencantumkan semua blob dalam kontainer
• Mencantumkan blob dengan awalan nama tertentu
• Mengimpor data menggunakan pernyataan COPY FROM
• Mengekspor data menggunakan pernyataan COPY TO
• Membaca konten dari blob
• Membaca, memfilter, dan memodifikasi konten yang dibaca dari blob
• Membaca konten dari file dengan opsi kustom (header, pemisah kolom, karakter escape)
• Gunakan opsi dekoder
• Menghitung agregasi atas konten blob
• Menulis konten ke blob
• Mencantumkan semua referensi ke akun penyimpanan Azure
• Mencabut akses dari pengguna atau peran pada referensi penyimpanan Azure Blob
• Menghapus referensi ke akun penyimpanan

Jika Anda perlu meninjau semua fungsi yang ditawarkan oleh ekstensi dan semua detail tentang masing-masing fungsi, tinjau referensi lengkap:

• azure_storage.account_add
• azure_storage.account_options_managed_identity
• azure_storage.account_options_credentials
• azure_storage.account_options
• azure_storage.account_remove
• azure_storage.account_user_add
• azure_storage.account_user_remove
• azure_storage.account_list
• azure_storage.blob_list
• azure_storage.blob_get
• azure_storage.blob_put
• azure_storage.options_csv_get
• azure_storage.options_copy
• azure_storage.options_tsv
• azure_storage.options_binary

Dan, jika Anda perlu melakukan beberapa pemecahan masalah, tinjau daftar kesalahan yang dapat dihasilkan ekstensi, dan konteks di mana mereka dapat dimunculkan.

Penting

Untuk jenis autentikasi yang harus Anda berikan kunci akses akun Azure Storage, perhatikan bahwa kunci akses Azure Storage Anda mirip dengan kata sandi akar untuk akun penyimpanan Anda. Selalu berhati-hatilah untuk melindungi mereka. Gunakan Azure Key Vault untuk mengelola dan memutar kunci Anda dengan aman. azure_storage ekstensi menyimpan kunci tersebut dalam tabel azure_storage.accounts, yang dapat dibaca oleh anggota pg_read_all_data peran.

Konten terkait

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