Aracılığıyla paylaş

PostgreSQL için Azure Veritabanı - Esnek Sunucuda geçiş hizmeti için Azure CLI'yi ayarlama

  • Makale

Azure CLI, Azure hizmetlerinde kaynak oluşturmak ve yönetmek için kullanılan bir komut kümesidir. Azure portalıyla aynı özellikleri sağlar ancak bir komut satırı ortamında çalışmayı tercih eden kullanıcılar için iyileştirilmiştir. Azure CLI kullanarak geçişe başlamak için Azure CLI'yı yerel makinenize yüklemeniz gerekir.

Önkoşullar

  • Azure CLI'yı yükleme: İşletim sisteminize bağlı olarak Azure CLI'yı indirip yükleyin. Windows, macOS ve Linux için kullanılabilir.
  • Azure CLI Yükleme Kılavuzu: Azure CLI'yi yüklemek için resmi Azure belgelerinde sağlanan yönergeleri izleyin - Azure CLI'yi yükleme.
  • Azure CLI Sürümünü denetleyin: Geçiş hizmeti için gerekli olduğundan Azure CLI sürümünüzün en az 2.56.0 veya üzeri olduğundan emin olun. Geçerli sürümünüzü denetlemek için komutunu az --version kullanın.
  • Azure'da oturum açın: Yüklemeden sonra kimlik doğrulaması yapmak için komutunu yürütür az login . Bu, Azure kimlik bilgilerinizle oturum açma işlemini tamamlamak için varsayılan tarayıcınızı açar.

Bu adımlar, PostgreSQL için Azure Veritabanı'da geçiş hizmetini etkili bir şekilde yönetmek için ortamınızı Azure CLI'yi kullanmaya hazırlar. Yükleme işleminde yapılan tüm güncelleştirmeler veya değişiklikler için her zaman en son Azure belgelerine bakın.

Geçiş hizmeti için CLI komutlarını ayarlama

Tüm CLI komutları ile az postgres flexible-server migrationbaşlar. Ayrıca, çeşitli seçenekleri anlamanıza ve CLI komutları için doğru söz dizimini çerçevelemenize yardımcı olacak yardım deyimleri de sağlanır.

CLI yüklendikten sonra komut istemini açın ve aşağıdaki komutu kullanarak Azure hesabında oturum açın.

az login

Geçiş komutları

Geçiş hizmeti, PostgreSQL örneklerinizi PostgreSQL için Azure Veritabanı - Esnek Sunucu'ya geçirmenize yardımcı olmak için aşağıdaki komutları sağlar.

Yardım komutu

--help Azure CLI'daki komut, işlemler için gerekli fiiller de dahil olmak üzere komutlar ve bunların alt komutları hakkında ayrıntılı belgeler sağlayan değerli bir seçenektir. komutu, –-helpgeçiş hizmeti için gerekli komutları ve bunların ilişkili eylemlerini PostgreSQL için Azure Veritabanı görüntüler.

az postgres flexible-server migration –-help

Çıkış, Azure CLI kullanarak veritabanı geçişlerinizi etkili bir şekilde yönetmek için gereken adımlar ve parametrelerde size yol gösterir.

Oluştur komutu

az postgres flexible-server migration create Azure CLI'daki komut, yeni bir geçiş iş akışı başlatmak için kullanılır. Veritabanlarının kaynak PostgreSQL örneğinden hedef PostgreSQL için Azure Veritabanı - Esnek Sunucu örneğine geçişini kolaylaştırır. Bu komut, sorunsuz ve verimli bir geçiş işlemi sağlamak için gerekli parametreleri ve yapılandırmaları ayarlar.

Daha fazla bilgi için bkz. az postgres flexible-server migration create

Listele komutu

az postgres flexible-server migration list komutu, bir PostgreSQL için Azure Veritabanı hedefine yapılan tüm geçiş girişimlerini listelemek için kullanılır. Bu komut, başlatılan geçişlere genel bir bakış sağlayarak her geçiş girişiminin durumunu ve ayrıntılarını izlemenize olanak sağlar.

Daha fazla bilgi için bkz. az postgres flexible-server migration list

Komutu göster

komutu az postgres flexible-server migration show , devam eden geçişleri izlemenize yardımcı olur ve geçişin geçerli durumunu ve alt durumunu verir. Bu ayrıntılar, geçişin geçerli durumu ve alt durumuyla ilgili bilgileri içerir.

Daha fazla bilgi için bkz. az postgres flexible-server migration show

Bazı olası geçiş durumları:

Geçiş durumları

Durum Açıklama
InProgress Geçiş altyapısı kurulumu devam ediyor veya gerçek veri geçişi devam ediyor.
İptal Edildi Geçiş iptal edilir veya silinir.
Başarısız oldu Geçiş başarısız oldu.
Doğrulama Başarısız Oldu Doğrulama başarısız oldu.
Başarılı Geçiş başarılı oldu ve tamamlandı.
WaitingForUserAction Yalnızca çevrimiçi geçiş için geçerlidir. Kullanıcı eyleminin tam geçişi gerçekleştirmesi bekleniyor.

Geçiş alt eyaletleri

Alt Durum Açıklama
PerformingPreRequisiteSteps Veri geçişi için altyapı kurulumu devam ediyor.
Doğrulama Sürüyor Doğrulama devam ediyor.
MigratingData Veri geçişi devam ediyor.
TamamlanıyorMigration Geçiş, tamamlanma işleminin son aşamalarındadır.
Tamamlandı Geçiş tamamlandı.
Başarısız oldu Geçiş başarısız oldu.

Doğrulama alt eyaletleri

Alt Durum Açıklama
Başarısız oldu Doğrulama başarısız oldu.
Başarılı Doğrulama başarılı oldu.
Uyarı Doğrulama uyarıda.

Güncelleştir komutu

az postgres flexible-server migration update komutu, PostgreSQL için Azure Veritabanı Esnek Sunucuya geçiş işlemini yönetmek için kullanılır. Özellikle şunları yapmak için kullanılabilir:

  • Tam geçiş gerçekleştirme: Bu işlem, kaynak sunucudan hedef Esnek Sunucuya veritabanı trafiğini geçirerek geçiş işlemini son haline getirir.
    • Temel veri geçişi tamamlandıktan sonra, geçiş görevi alt eyalete WaitingForCutoverTrigger taşınır. Bu durumda, kullanıcılar geçiş kılavuzunda veya CLI aracılığıyla geçiş adını seçerek portaldan tam geçişi tetikleyebilir.
    • Tam geçişi başlatmadan önce şunların sağlanması önemlidir:
      • Kaynağa yazma işlemleri durduruldu
      • latency değer 0'a düşer veya 0'a yakın
      • latency değeri hedefin kaynakla en son ne zaman eşitlendiğini gösterir. Bu noktada, kaynağa yazma işlemleri durdurulabilir ve tam geçiş başlatılabilir. Kaynakta yoğun trafik olması durumunda, 0'a yaklaşabilmek Latency için önce yazmaların durdurulması ve ardından tam geçişin başlatılması önerilir.
      • Tam Geçiş işlemi, Kaynaktan Hedefe bekleyen tüm değişiklikleri uygular ve geçişi tamamlar. Sıfır olmayan Latencyile bile bir "Tam Geçiş" tetiklerseniz, çoğaltma o noktaya kadar durur. Tam geçiş noktası hedefe uygulanana kadar kaynak üzerindeki tüm veriler. Tam geçiş noktasında gecikme süresinin 15 dakika olduğunu varsayalım, bu nedenle son 15 dakikadaki tüm değiştirilen veriler hedef için geçerlidir.
  • Geçişi iptal etme: Gerekirse, bu seçenek geçiş işlemini durdurmanıza olanak tanır.
  • Kaynakta mantıksal çoğaltmayı ayarlama: Bu, kaynak sunucu PostgreSQL için Azure Veritabanı - Tek Sunucu olduğunda, sunucuyu Esnek Sunucu'ya veri çoğaltması için hazırladığı için kullanışlıdır.

Daha fazla bilgi için bkz. az postgres flexible-server migration update

Özet

Aşağıdaki tablo, geçiş komutları tarafından kullanılan parametreleri özetler:

Parametre İlgili komutlar Açıklama
subscription oluşturma, listeleme, gösterme, güncelleştirme PostgreSQL Esnek sunucusunun Abonelik Kimliği
resource-group oluşturma, listeleme, gösterme, güncelleştirme PostgreSQL Esnek sunucusunun kaynak grubu
name oluşturma, listeleme, gösterme PostgreSQL Esnek sunucusunun adı
migration-name oluşturma, gösterme, güncelleştirme Esnek Sunucu'ya yapılan geçişlere yönelik benzersiz tanımlayıcı. Bu alan yalnızca alfasayısal karakterleri kabul eder ve kısa çizgi (-) dışında herhangi bir özel karakteri kabul etmez. Ad ile başlayamaz ve Esnek Sunucu hedefine yapılan iki geçiş aynı ada sahip olamaz.
filter listele Geçişleri filtrelemek için iki değer desteklenir: Etkin ve Tümü
help oluşturma, listeleme, gösterme, güncelleştirme Her komut hakkında bilgi sağlar.
migration-mode oluşturmaya Bu isteğe bağlı bir parametredir. İzin verilen Değerler çevrimdışı, çevrimiçidir. Varsayılan değer: Çevrimdışı.
migration-option oluşturmaya Geçişi tetiklemeden önce doğrulamalar gerçekleştirmenize olanak tanır. Varsayılan değer ValidateAndMigrate'tır. İzin verilen değerler şunlardır: Geçiş, Doğrulama, ValidateAndMigrate.
properties oluşturmaya Kaynak, hedef sunucu, geçirecek veritabanları, SSL modları, kaynak türlerini tanımlama hakkında bilgi içeren bir JSON dosyasının mutlak yolu

JSON dosyasının ayrıntıları

komutu az postgres flexible-server migration create , geçiş için kaynak veritabanı sunucusu kaynak kimliği, yönetici kimlik bilgileri, geçirebileceğiniz veritabanları ve diğer önemli ayarlar gibi yapılandırma ayrıntılarını içeren parametrenin --properties bir parçası olarak bir JSON dosya yolu gerektirir. Farklı özellikler aşağıdadır:

Özellik Adı Açıklama
sourceDbServerResourceId Şirket içi, sanal makineler (VM), bulut tabanlı PostgreSQL hizmeti - <<hostname or IP address>>:<<port>>@<<username>>biçimindeki kaynak sunucu ayrıntıları. Kaynak sunucu PostgreSQL için Azure Veritabanı - Tek sunucu ise kaynak kimliği şu biçimdedir:/subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Bu parametre, hem kaynak sunucu hem de hedef PostgreSQL esnek sunucusu için yönetici kullanıcıların parolalarını listeler. Bu parolalar kaynak ve hedef sunucularda kimlik doğrulamasına yardımcı olur. İki alt özelliği sourceServerPassword içerir ve targetServerPassword
targetServerUserName Varsayılan değer, PostgreSQL hedef esnek sunucusu oluşturulurken oluşturulan yönetici kullanıcıdır ve sağlanan parola bu kullanıcıya karşı kimlik doğrulaması için kullanılır.
dbsToMigrate Esnek Sunucu'ya geçirmek istediğiniz veritabanlarının listesini belirtin. Bir kerede en fazla sekiz veritabanı adı ekleyebilirsiniz. Dizi biçimindeKIB'lerin listesini sağlama.
overwriteDBsInTarget True (varsayılan) olarak ayarlandığında, hedef sunucuda geçirmeye çalıştığınız veritabanıyla aynı ada sahip bir veritabanı varsa, geçiş hizmeti otomatik olarak veritabanının üzerine yazar
migrationRuntimeResourceId Geçiş için bir çalışma zamanı sunucusunun kullanılması gerekiyorsa gereklidir. Biçimi: - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL Flexible Server name>>
sourceType Gerekli parametresi. Değerler olabilir: şirket içi, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Geçiş için SSL modları. PostgreSQLSingleServer için SSL modu VerifyFull ve Diğer kaynak türleri için Tercih Et/Gerektir'dir.

İlgili içerik