PostgreSQL için Azure Veritabanı'nda Azure Depolama uzantısını yapılandırma

Azure Depolama uzantısını kullanabilmek için şu adımları izlemeniz gerekir:

1. Azure Depolama hesaplarını tanımlama
2. Yetkilendirme türünü seçin
3. Uzantı kitaplığını yükleme
4. Uzantıyı izin verilenler listesine ekleme
5. Uzantıyı oluşturma
6. Verileri içeri ve dışarı aktarmak için uzantıyı kullanma

Azure Depolama hesaplarını tanımlama

Uzantı kullanıcılarının etkileşim kurmasını, verileri içeri aktarmasını veya dışarı aktarmasını istediğiniz Azure Depolama hesaplarını belirleyin.

Yetkilendirme türünü seçin

Bu Azure Depolama hesaplarının her birinin blob hizmetinde yapılan istekler için hangi tür yetkilendirmeyi kullanmak istediğinize karar verin. azure_storage uzantısı, Paylaşılan Anahtar ile yetkilendirmeyi ve Microsoft Entra Id ile yetkilendirmeyi destekler.

Bu iki yetkilendirme türünden Microsoft Entra ID, Paylaşılan Anahtar üzerinden üstün güvenlik ve kullanım kolaylığı sağlar ve Microsoft'un önerdiği kimliktir.

Her durumda gereken önkoşulları karşılamak için ilgili bölümlerdeki yönergeleri izleyin:

• Microsoft Entra Kimliği ile yetkilendirme veya
• Paylaşılan Anahtar ile Yetkilendirme.

Yetkilendirmeyi Microsoft Entra Id ile kullanmak için

1. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizde Sistem Tarafından Atanan Yönetilen Kimliği etkinleştirin.
2. Sistem tarafından atanan yönetilen kimliği etkinleştirdikten sonra PostgreSQL için Azure Veritabanı esnek sunucusu örneğini yeniden başlatın.
3. PostgreSQL için Azure Veritabanı esnek sunucu örneğinizin Sistem Tarafından Atanan Yönetilen Kimliğine Azure Depolama hesabındaki blob verilerine erişim için rol tabanlı erişim denetimi (RBAC) izinleri atayın.

Sistem Tarafından Atanan Yönetilen Kimliği Etkinleştirme

Azure portalı

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

Sunucuları Kullanma - REST API'yi güncelleştirme .

Paylaşılan Anahtar ile yetkilendirmeyi kullanmak için

1. Depolama hesabının anahtarına erişime izin verdiğinden emin olmak
2. Depolama hesabının iki erişim anahtarından birini getirme

Depolama hesabının anahtarına erişime izin verdiğinden emin olmak

Azure Depolama hesabınızda Depolama hesabı anahtarı erişimine izin ver etkin olmalıdır (yani AllowSharedKeyAccess özelliği false olarak ayarlanmamalıdır).

Azure portalı

CLI

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

REST API

Depolama Hesaplarını Kullanma - REST API'sini güncelleştirme.

Depolama hesabının iki erişim anahtarından birini getirme

bunu azure_storage.account_add işlevine geçirmek için Azure Depolama hesabının iki erişim anahtarından birini getirin.

Azure portalı

CLI

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

REST API

Depolama Hesaplarını Kullanma - Liste Anahtarları REST API'si.

Uzantı kitaplığını yükleme

Sunucunuzu, başlatıldığında ikili modülü yükleyebilecek azure_storage şekilde yapılandırın.

Azure portalı

shared_preload_libraries statik olduğundan, değişikliğin etkili olması için sunucunun yeniden başlatılması gerekir:

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 statik olduğundan, değişikliğin etkili olması için sunucunun yeniden başlatılması gerekir:

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

REST API

Yapılandırmaları Kullanma - REST API'sini yerleştirme.

shared_preload_libraries statik olduğundan, değişikliğin etkili olması için sunucunun yeniden başlatılması gerekir. Sunucuyu yeniden başlatmak için Sunucu - Rest API'yi Yeniden Başlat'ı kullanabilirsiniz.

Uzantıyı izin verilenler listesine ekleme

Kullanıcıların CREATE EXTENSION, DROP EXTENSION, ALTER EXTENSION, COMMENT ON EXTENSION komutunu çalıştırabilmesi için uzantıyı izin verilenler listesine eklemelisiniz.

Azure portalı

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

Yapılandırmaları Kullanma - REST API'sini yerleştirme.

Uzantıyı oluşturma

Azure Depolama uzantısını kullanmak istediğiniz veritabanına bağlanmak için Visual Studio Code için PostgreSQL (Önizleme), psql veya PgAdmin gibi tercih ettiğiniz istemciyi kullanın.

Uzantıyı kullanarak azure_storage Azure Depolama hesaplarının örnekleriyle etkileşim kurabileceğiniz tüm SQL nesnelerini (tablolar, türler, işlevler, görünümler vb.) oluşturmak için aşağıdaki deyimi yürütebilirsiniz:

CREATE EXTENSION azure_storage;

Verileri içeri ve dışarı aktarmak için uzantıyı kullanma

Artık etkileşime geçmek istediğiniz depolama hesaplarını eklemeye hazırsınız (işlevini kullanarak azure_storage.account_add ). Ardından işlevini veya deyimini kullanarak azure_storage.blob_get Azure Depolama hesaplarındaki dosyalarda depolanan verileri içeri aktarabilir veya COPY FROM postgreSQL'deki verileri, işlevini veya deyimini azure_storage.blob_put kullanarak Bir Azure Depolama hesabındaki dosyalara COPY TO aktarabilirsiniz.

Hızlı başlangıç örnekleri listesine göz atın:

• Azure Depolama hesabı oluşturma ve bunu verilerle doldurma
• Verilerin yüklendiği bir tablo oluşturma
• Depolama hesabının erişim anahtarını ekleme
• Azure Blob depolama başvurusunda bir kullanıcıya veya role erişim izni verme
• Kapsayıcıdaki tüm blobları listeleme
• Belirli bir ad ön ekiyle blobları listeleme
• COPY FROM deyimini kullanarak verileri içeri aktarma
• COPY TO deyimini kullanarak verileri dışarı aktarma
• Blobdan içerik okuma
• Blobdan okunan içeriği okuma, filtreleme ve değiştirme
• Özel seçeneklerle dosyadan içerik okuma (üst bilgiler, sütun sınırlayıcıları, kaçış karakterleri)
• Kod çözücü seçeneğini kullanma
• Blobun içeriği üzerinde işlem toplamaları
• Bloba içerik yazma
• Azure depolama hesaplarına yapılan tüm başvuruları listeleme
• Azure Blob depolama başvurusunda kullanıcı veya rolden erişimi iptal etme
• Depolama hesabına başvuruyu kaldırma

Uzantı tarafından sunulan tüm işlevleri ve bunların her biri hakkındaki tüm ayrıntıları gözden geçirmeniz gerekiyorsa, tam başvuruyu gözden geçirin:

• 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

Ayrıca, bazı sorun gidermeler yapmanız gerekiyorsa uzantının oluşturabileceği hataların listesini ve bunların yükseltilebileceği bağlamı gözden geçirin.

Önemli

Azure Depolama hesabı erişim anahtarı sağlamanız gereken kimlik doğrulama türleri için, Azure Depolama erişim anahtarlarınızın depolama hesabınızın kök parolasına benzer olduğuna dikkat edin. Onları korumak için her zaman dikkatli olun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek için Azure Key Vault'ı kullanın. azure_storageuzantı, bu anahtarları rolün pg_read_all_data üyeleri tarafından okunabilen bir tabloda azure_storage.accountsdepolar.

İlgili içerik

• Hızlı başlangıç örnekleri.
• Hataları giderin.
• Başvuru.
• Azure Depolama uzantısı.
• Uzantılar ve modüller.