إنشاء وإدارة النسخ المتماثلة للقراءة في قاعدة بيانات Azure ل PostgreSQL - خادم مرن من مدخل Microsoft Azure أو CLI أو واجهة برمجة تطبيقات REST

مقالة
08/15/2024

ينطبق على: قاعدة بيانات Azure ل PostgreSQL - خادم مرن

في هذه المقالة، ستتعلم كيفية إنشاء وإدارة النسخ المتماثلة للقراءة في قاعدة بيانات Azure لخادم PostgreSQL المرن من مدخل Microsoft Azure وCLI وواجهة برمجة تطبيقات REST. لمعرفة المزيد حول قراءة النسخ المتماثلة، راجع نظرة عامة.

المتطلبات الأساسية

قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن ليكون الخادم الأساسي.

إشعار

عند نشر النسخ المتماثلة للقراءة لأحمال العمل الأساسية كثيفة الكتابة المستمرة، يمكن أن يستمر تأخر النسخ المتماثل في النمو وقد لا يلحق أبدا بأحمال العمل الأساسية. قد يؤدي هذا أيضا إلى زيادة استخدام التخزين في الأساسي حيث يتم حذف ملفات WAL فقط بمجرد استلامها في النسخة المتماثلة.

مراجعة الإعدادات الأساسية

قبل إعداد نسخة متماثلة للقراءة لقاعدة بيانات Azure لخادم PostgreSQL المرن، تأكد من تكوين الخادم الأساسي لتلبية المتطلبات الأساسية الضرورية. يمكن أن تؤثر الإعدادات المحددة على الخادم الأساسي على القدرة على إنشاء نسخ متماثلة.

النمو التلقائي للتخزين: يجب أن تلتزم إعدادات التخزين التلقائي على الخادم الأساسي والنسخ المتماثلة للقراءة الخاصة به بإرشادات محددة لضمان التناسق ومنع اضطرابات النسخ المتماثل. راجع التخزين التلقائي للحصول على القواعد والإعدادات التفصيلية.

Premium SSD v2: لا يدعم الإصدار الحالي إنشاء نسخ متماثلة للقراءة للخوادم الأساسية باستخدام تخزين Premium SSD v2. إذا كان حمل العمل يتطلب قراءة النسخ المتماثلة، فاختر خيار تخزين مختلف للخادم الأساسي.

في مدخل Microsoft Azure، اختر مثيل خادم Azure Database for PostgreSQL المرن الذي تريده للنسخة المتماثلة.
في مربع الحوار نظرة عامة ، لاحظ إصدار PostgreSQL (على سبيل المثال 15.4). لاحظ أيضا المنطقة التي يتم نشر الأساسي فيها (على سبيل المثال، East US).
على الشريط الجانبي للخادم، ضمن Settings، حدد Compute + storage.
راجع الإعدادات التالية ولاحظها:
- طبقة الحوسبة، المعالج، الحجم (على سبيل المثال Standard_D4ads_v5).
- التخزين
  - حجم التخزين (على سبيل المثال 128GB)
  - النمو التلقائي
- قابلية الوصول العالية
  - ممكن / معطل
  - إعدادات منطقة التوفر
- إعدادات النسخ الاحتياطي
  - فترة الاستبقاء
  - خيارات التكرار
ضمن الإعدادات، حدد الشبكات.
مراجعة إعدادات الشبكة.

إشعار

تنطبق الأوامر المتوفرة في هذا الدليل على الإصدار 2.56.0 من Azure CLI أو أعلى. تأكد من تثبيت الإصدار المطلوب أو الإصدار الأحدث لتنفيذ هذه الأوامر بنجاح. يمكنك التحقق من إصدار Azure CLI الحالي عن طريق التشغيل az --version في واجهة سطر الأوامر. لتحديث Azure CLI إلى أحدث إصدار، اتبع الإرشادات المتوفرة في وثائق Azure CLI.

لعرض التكوين والحالة الحالية لخادم Azure PostgreSQL المرن، استخدم az postgres flexible-server show الأمر . يوفر هذا الأمر معلومات مفصلة حول الخادم المحدد.

az postgres flexible-server show \
  --resource-group <resource-group> \
  --name <server-name>

استبدل <resource-group> و <server-name> بمجموعة الموارد المحددة واسم الخادم الذي ترغب في عرضه.

راجع الإعدادات التالية ولاحظها:

طبقة الحوسبة، المعالج، الحجم (على سبيل المثال Standard_D8ads_v5).
التخزين
- نوع
- حجم التخزين (على سبيل المثال 128)
- ميزة autogrow
قابلية وصول عالية
- ممكن / معطل
- إعدادات منطقة التوفر
إعدادات النسخ الاحتياطي
- فترة الاستبقاء
- خيارات التكرار

نموذج الاستجابة

{
  "administratorLogin": "myadmin",
  "administratorLoginPassword": null,
  "authConfig": {
    "activeDirectoryAuth": "Disabled",
    "passwordAuth": "Enabled",
    "tenantId": null
  },
  "availabilityZone": "2",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2024-01-06T11:43:44.485537+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "createMode": null,
  "dataEncryption": {
    "geoBackupEncryptionKeyStatus": null,
    "geoBackupKeyUri": null,
    "geoBackupUserAssignedIdentityId": null,
    "primaryEncryptionKeyStatus": null,
    "primaryKeyUri": null,
    "primaryUserAssignedIdentityId": null,
    "type": "SystemManaged"
  },
  "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
  "highAvailability": {
    "mode": "Disabled",
    "standbyAvailabilityZone": null,
    "state": "NotEnabled"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
  "identity": null,
  "location": "East US",
  "maintenanceWindow": {
    "customWindow": "Disabled",
    "dayOfWeek": 0,
    "startHour": 0,
    "startMinute": 0
  },
  "minorVersion": "0",
  "name": "{serverName}",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "pointInTimeUtc": null,
  "privateEndpointConnections": null,
  "replica": {
    "capacity": 5,
    "promoteMode": null,
    "promoteOption": null,
    "replicationState": null,
    "role": "Primary"
  },
  "replicaCapacity": 5,
  "replicationRole": "Primary",
  "resourceGroup": "{resourceGroupName}",
  "sku": {
    "name": "Standard_D8ads_v5",
    "tier": "GeneralPurpose"
  },
  "sourceServerResourceId": null,
  "state": "Ready",
  "storage": {
    "autoGrow": "Disabled",
    "iops": 500,
    "storageSizeGb": 128,
    "throughput": null,
    "tier": "P10",
    "type": ""
  },
  "systemData": {
    "createdAt": "2023-11-08T11:27:48.972812+00:00",
    "createdBy": null,
    "createdByType": null,
    "lastModifiedAt": null,
    "lastModifiedBy": null,
    "lastModifiedByType": null
  },
  "tags": {},
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "16"
}

للحصول على معلومات حول تكوين خادم في قاعدة بيانات Azure لخادم PostgreSQL المرن، خاصة لعرض إعدادات الميزات التي تم تقديمها مؤخرا مثل التخزين التلقائي أو الارتباط الخاص، يجب استخدام أحدث إصدار 2023-06-01-previewمن واجهة برمجة التطبيقات . GET سيتم تنسيق الطلب على النحو التالي:

https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}?api-version=2023-06-01-preview

استبدل {subscriptionId}و {resourceGroupName}و {serverName} بمعرف اشتراك Azure واسم مجموعة الموارد واسم الخادم الأساسي الذي تريد مراجعته، على التوالي. يمنحك هذا الطلب حق الوصول إلى تفاصيل التكوين الخاصة بالخادم الأساسي، مما يضمن إعداده بشكل صحيح لإنشاء نسخة متماثلة للقراءة.

راجع الإعدادات التالية ولاحظها:

طبقة الحوسبة، المعالج، الحجم (على سبيل المثال Standard_D8ads_v5).
التخزين
- نوع
- حجم التخزين (على سبيل المثال 128)
- ميزة autogrow
الشبكة
قابلية وصول عالية
- ممكن / معطل
- إعدادات منطقة التوفر
إعدادات النسخ الاحتياطي
- فترة الاستبقاء
- خيارات التكرار

نموذج الاستجابة

{
    "sku": {
        "name": "Standard_D8ads_v5",
        "tier": "GeneralPurpose"
    },
    "systemData": {
        "createdAt": "2023-11-22T16:11:42.2461489Z"
    },
    "properties": {
        "replica": {
            "role": "Primary",
            "capacity": 5
        },
        "storage": {
            "type": "",
            "iops": 500,
            "tier": "P10",
            "storageSizeGB": 128,
            "autoGrow": "Disabled"
        },
        "network": {
            "publicNetworkAccess": "Enabled"
        },
        "dataEncryption": {
            "type": "SystemManaged"
        },
        "authConfig": {
            "activeDirectoryAuth": "Disabled",
            "passwordAuth": "Enabled"
        },
        "fullyQualifiedDomainName": "{serverName}.postgres.database.azure.com",
        "version": "15",
        "minorVersion": "4",
        "administratorLogin": "myadmin",
        "state": "Ready",
        "availabilityZone": "1",
        "backup": {
            "backupRetentionDays": 7,
            "geoRedundantBackup": "Disabled",
            "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00"
        },
        "highAvailability": {
            "mode": "Disabled",
            "state": "NotEnabled"
        },
        "maintenanceWindow": {
            "customWindow": "Disabled",
            "dayOfWeek": 0,
            "startHour": 0,
            "startMinute": 0
        },
        "replicationRole": "Primary",
        "replicaCapacity": 5
    },
    "location": "East US",
    "tags": {},
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "name": "{serverName}",
    "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}

إنشاء نسخة متماثلة للقراءة

لإنشاء نسخة متماثلة للقراءة، اتبع الخطوات التالية:

حدد قاعدة بيانات Azure موجودة لمثيل خادم PostgreSQL المرن لاستخدامه كخادم أساسي.
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication.
حدد Create replica.
أدخل نموذج الأساسيات بالمعلومات التالية.
حدد Review + create لتأكيد إنشاء النسخة المتماثلة أو Next: Networking إذا كنت تريد إضافة أي قواعد جدار حماية أو حذفها أو تعديلها.
اترك الإعدادات الافتراضية المتبقية ثم حدد الزر Review + create في أسفل الصفحة أو انتقل إلى النماذج التالية لإضافة علامات أو تغيير طريقة تشفير البيانات.
راجع المعلومات فـي نافذة التأكيد النهائية. عندما تكون مستعداً، حدد Create. يتم إنشاء نشر جديد.
أثناء النشر، سترى الأساسي في Updating الحالة.

بعد إنشاء النسخة المتماثلة للقراءة، يمكن عرضها من نافذة النسخ المتماثل .

يمكنك إنشاء نسخة متماثلة للقراءة لخادم Azure PostgreSQL المرن باستخدام az postgres flexible-server replica create الأمر .

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

استبدل <replica-name>و <source-server-name><resource-group>و بقيمك <location> المحددة.

بعد إنشاء النسخة المتماثلة للقراءة، يمكن الحصول على خصائص كافة الخوادم، وهي نسخ متماثلة من نسخة متماثلة az postgres flexible-server replica create أساسية باستخدام الأمر .

az postgres flexible-server replica list \
  --name <source-server-name> \
  --resource-group <resource-group>

استبدل <source-server-name>، و <resource-group> بقيمك المحددة.

HTTP PUT بدء طلب باستخدام الخوادم إنشاء API:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

هنا، تحتاج إلى استبدال {subscriptionId}و {resourceGroupName}و {replicaserverName} بمعرف اشتراك Azure المحدد واسم مجموعة الموارد والاسم المطلوب للنسخة المتماثلة للقراءة، على التوالي.

{
  "location": "eastus",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

بعد إنشاء النسخة المتماثلة للقراءة، يمكن الحصول على خصائص كافة الخوادم، وهي نسخ متماثلة من نسخة متماثلة أساسية عن طريق بدء HTTP GET طلب باستخدام قائمة النسخ المتماثلة بواسطة واجهة برمجة تطبيقات الخادم:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/replicas?api-version=2022-12-01

هنا، تحتاج إلى استبدال {subscriptionId}و {resourceGroupName}و {sourceserverName} بمعرف اشتراك Azure المحدد واسم مجموعة الموارد والاسم الذي قمت بتعيينه إلى النسخة المتماثلة الأساسية الخاصة بك، على التوالي.

[
  {
    "administratorLogin": null,
    "administratorLoginPassword": null,
    "authConfig": null,
    "availabilityZone": null,
    "backup": {
      "backupRetentionDays": null,
      "earliestRestoreDate": "2023-11-23T12:55:33.3443218+00:00",
      "geoRedundantBackup": "Disabled"
    },
    "createMode": null,
    "dataEncryption": {
      "geoBackupEncryptionKeyStatus": null,
      "geoBackupKeyUri": null,
      "geoBackupUserAssignedIdentityId": null,
      "primaryEncryptionKeyStatus": null,
      "primaryKeyUri": null,
      "primaryUserAssignedIdentityId": null,
      "type": "SystemManaged"
    },
    "fullyQualifiedDomainName": null,
    "highAvailability": null,
    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{replicaserverName}",
    "identity": null,
    "location": "eastus",
    "maintenanceWindow": {
      "customWindow": "Disabled",
      "dayOfWeek": 0,
      "startHour": 0,
      "startMinute": 0
    },
    "minorVersion": null,
    "name": "{replicaserverName}",
    "network": {
      "delegatedSubnetResourceId": null,
      "privateDnsZoneArmResourceId": null,
      "publicNetworkAccess": "Disabled"
    },
    "pointInTimeUtc": null,
    "privateEndpointConnections": null,
    "replica": {
      "capacity": null,
      "promoteMode": null,
      "promoteOption": null,
      "replicationState": "Active",
      "role": "AsyncReplica"
    },
    "replicaCapacity": null,
    "replicationRole": "AsyncReplica",
    "resourceGroup": "{resourceGroupName}",
    "sku": {
      "name": "",
      "tier": null
    },
    "sourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}",
    "state": "Ready",
    "storage": {
      "autoGrow": "Disabled",
      "iops": null,
      "storageSizeGb": 0,
      "throughput": null,
      "tier": null,
      "type": null
    },
    "systemData": {
      "createdAt": "2023-11-22T17:11:42.2461489Z",
      "createdBy": null,
      "createdByType": null,
      "lastModifiedAt": null,
      "lastModifiedBy": null,
      "lastModifiedByType": null
    },
    "tags": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers",
    "version": null
  }
]

تعيين اسم خادم النسخة المتماثلة.

تلميح

من أفضل ممارسات Cloud Adoption Framework (CAF) استخدام اصطلاح تسمية الموارد الذي سيسمح لك بسهولة بتحديد المثيل الذي تتصل به أو تديره ومكان وجوده.
حدد موقعا مختلفا عن الموقع الأساسي ولكن لاحظ أنه يمكنك تحديد نفس المنطقة.

تلميح

لمعرفة المزيد حول المناطق التي يمكنك إنشاء نسخة متماثلة فيها، تفضل بزيارة مقالة مفاهيم النسخ المتماثلة للقراءة.
قم بتعيين الحساب والتخزين إلى ما قمت بتسجيله من الأساسي. إذا لم تتطابق الحوسبة المعروضة، فحدد تكوين الخادم وحدد الخادم المناسب.

إشعار

إذا حددت حجم حساب أصغر من الحجم الأساسي، فسيفشل النشر. يجب أيضا أن تدرك أن حجم الحساب قد لا يكون متوفرا في منطقة مختلفة.

هام

يرجى مراجعةقسم الاعتبارات لنظرة عامة على قراءة النسخة المتماثلة.

لتجنب المشكلات أثناء ترقية النسخ المتماثلة باستمرار تغيير معلمات الخادم التالية على النسخ المتماثلة أولا، قبل تطبيقها على الأساسي: max_connections، max_prepared_transactions، max_locks_per_transaction، ، max_wal_senders. max_worker_processes

إنشاء نقاط نهاية ظاهرية

إشعار

يتم تنفيذ جميع العمليات التي تتضمن نقاط النهاية الظاهرية - مثل الإضافة أو التحرير أو الإزالة - في سياق الخادم الأساسي.

في مدخل Microsoft Azure، حدد الخادم الأساسي.
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication.
حدد Create endpoint.
في مربع الحوار، اكتب اسما ذا معنى لنقطة النهاية. لاحظ نقطة نهاية DNS التي يتم إنشاؤها.
حدد إنشاء.

إشعار

إذا لم تقم بإنشاء نقطة نهاية ظاهرية، فستتلقى خطأ في محاولة ترقية النسخة المتماثلة.

يمكنك إنشاء نقطة نهاية ظاهرية az postgres flexible-server virtual-endpoint create باستخدام الأمر .

    az postgres flexible-server virtual-endpoint create \
      --resource-group <resource-group> \
      --server-name <primary-name> \
      --name <virtual-endpoint-name> \
      --endpoint-type ReadWrite \
      --members <replica-name>

استبدل <resource-group>و <virtual-endpoint-name><primary-name>و بقيمك <replica-name> المحددة.

لإنشاء نقطة نهاية ظاهرية باستخدام واجهة برمجة تطبيقات REST الخاصة ب Azure، يمكنك استخدام HTTP PUT طلب. سيبدو الطلب كما يلي:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

نص JSON المصاحب لهذا الطلب كما يلي:

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
}

هنا، {replicaserverName} يجب استبدال باسم خادم النسخة المتماثلة الذي تقوم بتضمينه كهدف نقطة نهاية قارئ في نقطة النهاية الظاهرية هذه.

سرد نقاط النهاية الظاهرية

لسرد نقاط النهاية الظاهرية، استخدم الخطوات التالية:

في مدخل Microsoft Azure، حدد الخادم الأساسي .
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication.
في أعلى الصفحة، ترى كل من نقاط نهاية القارئ والكاتب معروضة، بالإضافة إلى أسماء الخوادم التي يشيرون إليها.

يمكنك عرض تفاصيل نقطة النهاية الظاهرية باستخدام الأمر list أو show . نظرا إلى أنه يسمح بنقطة نهاية ظاهرية واحدة فقط لكل زوج من النسخ المتماثلة الأساسية، ينتج عن كلا الأمرين نفس النتيجة.

فيما يلي مثال على كيفية استخدام list الأمر:

az postgres flexible-server virtual-endpoint list \
      --resource-group <resource-group> \
      --server-name <server-name>

استبدل <server-name> باسم الخادم الأساسي واسم <resource-group> مجموعة الموارد الخاصة بك.

فيما يلي كيفية استخدام show الأمر:

az postgres flexible-server virtual-endpoint show \
      --name <virtual-endpoint-name>
      --resource-group <resource-group> \
      --server-name <server-name>

في هذا الأمر، استبدل <virtual-endpoint-name>و<server-name> و <resource-group> بالأسماء المعنية. <server-name> هو اسم الخادم الأساسي.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints?api-version=2023-06-01-preview

هنا، {sourceserverName} يجب أن يكون اسم الخادم الأساسي الذي تدير منه نقاط النهاية الظاهرية.

تعديل التطبيق للإشارة إلى نقطة النهاية الظاهرية

تعديل أي تطبيقات تستخدم قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن لاستخدام نقاط النهاية الظاهرية الجديدة (على سبيل المثال: corp-pg-001.writer.postgres.database.azure.com و corp-pg-001.reader.postgres.database.azure.com).

ترقية النسخ المتماثلة

مع وجود جميع المكونات الضرورية في مكانها، فأنت مستعد لتنفيذ نسخة متماثلة ترقية إلى العملية الأساسية.

لتعزيز النسخة المتماثلة من مدخل Microsoft Azure، اتبع الخطوات التالية:

في مدخل Microsoft Azure، حدد قاعدة بيانات Azure الأساسية لمثيل خادم PostgreSQL المرن.
في قائمة الخادم، ضمن Settings، حدد Replication.
ضمن Servers، حدد رمز Promote للنسخة المتماثلة.
في مربع الحوار، تأكد من أن الإجراء هو ترقية إلى الخادم الأساسي.
بالنسبة لمزامنة البيانات، تأكد من التخطيط - مزامنة البيانات قبل تحديد الترقية.
حدد ترقية لبدء العملية. بمجرد اكتماله، تعكس الأدوار: تصبح النسخة المتماثلة هي الأساسية، وتفترض النسخة الأساسية دور النسخة المتماثلة.

عند ترقية نسخة متماثلة إلى خادم أساسي في Azure PostgreSQL Flexible Server، استخدم az postgres flexible-server replica promote الأمر . هذه العملية ضرورية لرفع خادم النسخة المتماثلة للعمل كخادم أساسي وخفض الدور الأساسي الحالي إلى دور النسخة المتماثلة. حدد --promote-mode switchover و --promote-option planned في الأمر .

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

استبدل <resource-group> و <replica-server-name> بمجموعة الموارد المحددة واسم خادم النسخة المتماثلة. يضمن هذا الأمر انتقالا سلسا للنسخة المتماثلة إلى دور أساسي بطريقة مخططة.

عند ترقية نسخة متماثلة إلى خادم أساسي، استخدم HTTP PATCH طلبا مع نص معين JSON لتعيين خيارات الترقية. هذه العملية ضرورية عندما تحتاج إلى رفع خادم النسخة المتماثلة للعمل كخادم أساسي.

HTTP يتم تنظيم الطلب على النحو التالي:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

في هذا JSON، يتم تعيين الترقية إلى أن تحدث في switchover الوضع مع خيار ترقية planned . في حين أن هناك خيارين للترقية - planned أو forced - تم اختيارهما planned لهذا التمرين.

إشعار

يجب أن يكون للنسخة المتماثلة التي تقوم بالترويج لها نقطة نهاية ظاهرية للقارئ معينة، أو ستتلقى خطأ في الترقية.

اختبار التطبيقات

لتنفيذ بعض العمليات، أعد تشغيل التطبيقات ثم حاول تنفيذ هذه العمليات. يجب أن تعمل تطبيقاتك بسلاسة دون تعديل نقطة النهاية الظاهرية سلسلة الاتصال أو إدخالات DNS. اترك تطبيقاتك قيد التشغيل هذه المرة.

إرجاع الموارد إلى الخادم والمنطقة الأصليين

كرر نفس العمليات لترويج الخادم الأصلي إلى الأساسي.

في مدخل Microsoft Azure، حدد النسخة المتماثلة.
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication
ضمن Servers، حدد رمز Promote للنسخة المتماثلة.
في مربع الحوار، تأكد من أن الإجراء هو ترقية إلى الخادم الأساسي.
بالنسبة لمزامنة البيانات، تأكد من التخطيط - مزامنة البيانات قبل تحديد الترقية.
حدد ترقية، تبدأ العملية. بمجرد اكتماله، تعكس الأدوار: تصبح النسخة المتماثلة هي الأساسية، وتفترض النسخة الأساسية دور النسخة المتماثلة.

هذه المرة، قم بتغيير <replica-server-name> في az postgres flexible-server replica promote الأمر للإشارة إلى الخادم الأساسي القديم الخاص بك، والذي يعمل حاليا كنسخة متماثلة، وتنفيذ الطلب مرة أخرى.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name> \
  --promote-mode switchover \
  --promote-option planned

استبدل <resource-group> و <replica-server-name> بمجموعة الموارد المحددة واسم خادم النسخة المتماثلة الحالي.

هذه المرة، قم بتغيير {replicaserverName} في طلب واجهة برمجة التطبيقات للإشارة إلى الخادم الأساسي القديم، والذي يعمل حاليا كنسخة متماثلة، وقم بتنفيذ الطلب مرة أخرى.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "switchover",
      "PromoteOption": "planned"
    }
  }
}

اختبار التطبيقات

مرة أخرى، قم بالتبديل إلى أحد التطبيقات المستهلكة. انتظر حتى تتغير الحالة الأساسية والنسخة المتماثلة إلى Updating ثم حاول تنفيذ بعض العمليات. أثناء ترقية النسخة المتماثلة، قد يواجه تطبيقك مشكلات اتصال مؤقتة بنقطة النهاية:

إضافة نسخة متماثلة للقراءة الثانوية

إنشاء نسخة متماثلة ثانوية للقراءة في منطقة منفصلة لتعديل نقطة النهاية الظاهرية للقارئ والسماح بإنشاء خادم مستقل من النسخة المتماثلة الأولى.

في مدخل Microsoft Azure، اختر قاعدة بيانات Azure الأساسية لمثيل خادم PostgreSQL المرن.
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication.
حدد Create replica.
أدخل نموذج الأساسيات مع معلومات في منطقة ثالثة (على سبيل المثال westus و corp-pg-westus-001)
حدد Review + create لتأكيد إنشاء النسخة المتماثلة أو Next: Networking إذا كنت تريد إضافة أي قواعد جدار حماية أو حذفها أو تعديلها.
تحقق من إعدادات جدار الحماية. لاحظ كيفية نسخ الإعدادات الأساسية تلقائيا.
اترك الإعدادات الافتراضية المتبقية ثم حدد الزر Review + create في أسفل الصفحة أو انتقل إلى النماذج التالية لتكوين الأمان أو إضافة علامات.
راجع المعلومات فـي نافذة التأكيد النهائية. عندما تكون مستعداً، حدد Create. يتم إنشاء نشر جديد.
أثناء النشر، سترى الأساسي في Updating الحالة.

يمكنك إنشاء نسخة متماثلة ثانوية للقراءة az postgres flexible-server replica create باستخدام الأمر .

az postgres flexible-server replica create \
  --replica-name <replica-name> \
  --resource-group <resource-group> \
  --source-server <source-server-name> \
  --location <location>

اختر اسما <replica-name> مميزا لتمييزه عن الخادم الأساسي وأي نسخ متماثلة أخرى. استبدل <resource-group>و <source-server-name>و <location> بقيمك المحددة.

يمكنك إنشاء نسخة متماثلة ثانوية للقراءة باستخدام واجهة برمجة تطبيقات إنشاء الخوادم:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

اختر اسما {replicaserverName} مميزا لتمييزه عن الخادم الأساسي وأي نسخ متماثلة أخرى.

{
  "location": "westus3",
  "properties": {
    "createMode": "Replica",
    "SourceServerResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}"
  }
}

تم تعيين الموقع إلى westus3، ولكن يمكنك ضبط الإعداد بناء على احتياجاتك الجغرافية والتشغيلية.

تعديل نقطة النهاية الظاهرية

في مدخل Microsoft Azure، اختر قاعدة بيانات Azure الأساسية لمثيل خادم PostgreSQL المرن.
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication.
حدد علامات الحذف ثم حدد تحرير.
في مربع الحوار، حدد النسخة المتماثلة الثانوية الجديدة.
حدد حفظ. يتم الآن توجيه نقطة نهاية القارئ إلى النسخة المتماثلة الثانوية، ويتم ربط عملية الترقية الآن بهذه النسخة المتماثلة.

يمكنك الآن تعديل نقطة نهاية القارئ للإشارة إلى النسخة المتماثلة الثانوية التي تم إنشاؤها حديثا باستخدام أمر az postgres flexible-server virtual-endpoint update . تذكر استبدال <replica-name> باسم النسخة المتماثلة للقراءة التي تم إنشاؤها حديثا.

az postgres flexible-server virtual-endpoint update \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name> \
  --endpoint-type ReadWrite \
  --members <replica-name>

استبدل <resource-group>و <virtual-endpoint-name><server-name>و بقيمك <replica-name> المحددة.

يمكنك الآن تعديل نقطة نهاية القارئ للإشارة إلى النسخة المتماثلة الثانوية التي تم إنشاؤها PATCH حديثا باستخدام طلب. تذكر استبدال {replicaserverName} باسم النسخة المتماثلة للقراءة التي تم إنشاؤها حديثا.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

{ 
  "Properties": { 
    "EndpointType": "ReadWrite", 
    "Members": ["{replicaserverName}"] 
  }
}

ترقية النسخة المتماثلة إلى خادم مستقل

بدلا من التبديل إلى نسخة متماثلة، من الممكن أيضا قطع النسخ المتماثل للنسخة المتماثلة بحيث تصبح خادمها المستقل.

في مدخل Microsoft Azure، اختر خادم خادم أساسي مرن لقاعدة بيانات Azure ل PostgreSQL.
على الشريط الجانبي للخادم، في قائمة الخادم، ضمن Settings، حدد Replication.
ضمن الخوادم، حدد أيقونة ترقية للنسخة المتماثلة التي تريد ترقيتها إلى خادم مستقل.
في مربع الحوار، تأكد من أن الإجراء هو ترقية إلى خادم مستقل وإزالته من النسخ المتماثل. لن يؤثر هذا على الخادم الأساسي.
بالنسبة لمزامنة البيانات، تأكد من التخطيط - مزامنة البيانات قبل تحديد الترقية.
حدد ترقية، تبدأ العملية. بمجرد الانتهاء، لم يعد الخادم نسخة متماثلة من الأساسي.

عند ترقية نسخة متماثلة في Azure PostgreSQL Flexible Server، فإن السلوك الافتراضي هو ترقيتها إلى خادم مستقل. يتم تحقيق الترقية az postgres flexible-server replica promote باستخدام الأمر دون تحديد --promote-mode الخيار، حيث standalone يتم افتراض الوضع افتراضيا.

az postgres flexible-server replica promote \
  --resource-group <resource-group> \
  --name <replica-server-name>

في هذا الأمر، استبدل <resource-group> و <replica-server-name> باسم مجموعة الموارد المحددة واسم خادم النسخة المتماثلة الأول الذي قمت بإنشائه، وهذا ليس جزءا من نقطة النهاية الظاهرية بعد الآن.

يمكنك ترقية نسخة متماثلة إلى خادم مستقل باستخدام PATCH طلب. PATCH أرسل طلبا إلى عنوان URL المحدد لواجهة برمجة تطبيقات REST لإدارة Azure مع النص الأساسي الأولJSON، حيث PromoteMode يتم تعيين إلى standalone وإلى PromoteOption planned. تم إهمال تنسيق النص الثاني JSON ، إعداد ReplicationRole إلى None، ولكن لا يزال مذكورا هنا للتوافق مع الإصدارات السابقة.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2023-06-01-preview

{
  "Properties": {
    "Replica": {
      "PromoteMode": "standalone",
      "PromoteOption": "planned"
    }
  }
}

{
  "Properties": {
    "ReplicationRole": "None"
  }
}

إشعار

بمجرد ترقية النسخة المتماثلة إلى خادم مستقل، لا يمكن إضافتها مرة أخرى إلى مجموعة النسخ المتماثل.

حذف نقطة النهاية الظاهرية

في مدخل Microsoft Azure، حدد الخادم الأساسي .
على الشريط الجانبي للخادم، ضمن Settings، حدد Replication.
في أعلى الصفحة، حدد موقع Virtual endpoints المقطع. انتقل إلى النقاط الثلاث (خيارات القائمة) بجوار اسم نقطة النهاية، وقم بتوسيعه، واختر Delete.
يظهر مربع حوار تأكيد الحذف. يحذرك: "يحذف هذا الإجراء نقطة virtualendpointNameالنهاية الظاهرية . قد يفقد أي عملاء متصلين باستخدام هذه المجالات إمكانية الوصول." قم بالإقرار بالآثار والتأكيد بالنقر فوق حذف.

لإزالة نقطة نهاية ظاهرية من خادم Azure PostgreSQL المرن، يمكنك استخدام az postgres flexible-server virtual-endpoint delete الأمر . يحذف هذا الإجراء نقطة النهاية الظاهرية المحددة بشكل دائم.

az postgres flexible-server virtual-endpoint delete \
  --resource-group <resource-group> \
  --server-name <server-name> \
  --name <virtual-endpoint-name>

في هذا الأمر، استبدل <resource-group>و <server-name>و <virtual-endpoint-name> بمجموعة الموارد المحددة واسم الخادم واسم نقطة النهاية الظاهرية التي ترغب في حذفها.

لحذف نقطة نهاية ظاهرية باستخدام واجهة برمجة تطبيقات REST الخاصة ب Azure، يمكنك إصدار HTTP DELETE طلب. سيتم تنظيم عنوان URL للطلب على النحو التالي:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{serverName}/virtualendpoints/{virtualendpointName}?api-version=2023-06-01-preview

حذف نسخة متماثلة

يمكنك حذف نسخة متماثلة للقراءة مشابهة لكيفية حذف قاعدة بيانات Azure المستقلة لمثيل خادم PostgreSQL المرن.

في مدخل Microsoft Azure، افتح صفحة Overview للنسخة المتماثلة للقراءة. حدد حذف.

يمكنك أيضاً حذف النسخة المتماثلة للقراءة من نافذة النسخ المتماثل باتباع الخطوات التالية:

في مدخل Microsoft Azure، حدد قاعدة بيانات Azure الأساسية لمثيل خادم PostgreSQL المرن.
في قائمة الخادم، ضمن Settings، حدد Replication.
حدد النسخة المتماثلة للقراءة لحذفها ثم حدد علامات الحذف. حدد حذف.
الإقرار بعملية الحذف .

لحذف خادم أساسي أو خادم نسخة متماثلة az postgres flexible-server delete ، استخدم الأمر . إذا كان الخادم يحتوي على نسخ متماثلة للقراءة، فيجب عليك حذف النسخ المتماثلة للقراءة أولا قبل حذف الخادم الأساسي.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

استبدل <resource-group> و <server-name> باسم مجموعة الموارد واسم خادم النسخة المتماثلة الذي ترغب في حذفه.

لحذف خادم أساسي أو خادم نسخة متماثلة، استخدم الخوادم حذف API. إذا كان الخادم يحتوي على نسخ متماثلة للقراءة، فيجب حذف النسخ المتماثلة للقراءة أولا قبل حذف الخادم الأساسي.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{replicaserverName}?api-version=2022-12-01

حذف خادم أساسي

يمكنك حذف الخادم الأساسي فقط بمجرد حذف جميع النسخ المتماثلة للقراءة. لحذف النسخ المتماثلة، اتبع الإرشادات الموجودة في قسم حذف نسخة متماثلة ثم تابع الخطوات المتوفرة.

لحذف خادم من مدخل Microsoft Azure، اتبع الخطوات التالية:

في مدخل Microsoft Azure، حدد قاعدة بيانات Azure الأساسية لمثيل خادم PostgreSQL المرن.
افتح صفحة Overview للخادم وحدد Delete.
أدخل اسم الخادم الأساسي المراد حذفه. حدد حذف لتأكيد حذف الخادم الأساسي.

لحذف خادم أساسي أو خادم نسخة متماثلة az postgres flexible-server delete ، استخدم الأمر . إذا كان الخادم يحتوي على نسخ متماثلة للقراءة، فيجب حذف النسخ المتماثلة للقراءة أولا قبل حذف الخادم الأساسي.

az postgres flexible-server delete \
  --resource-group <resource-group> \
  --name <server-name>

استبدل <resource-group> و <server-name> باسم مجموعة الموارد واسم الخادم الأساسي الذي ترغب في حذفه.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/flexibleServers/{sourceserverName}?api-version=2022-12-01

مراقبة نسخة متماثلة

يتوفر مقياسان لمراقبة النسخ المتماثلة للقراءة.

الحد الأقصى لتأخر النسخ المتماثل الفعلي

متوفر فقط على الأساسي.

يظهر مقياس Max Physical Replication Lag تأخر البايت بين الخادم الأساسي والنسخة المتماثلة الأكثر تأخرا.

في مدخل Microsoft Azure، حدد الخادم الأساسي.
حدد القياسات. في نافذة Metrics ، حدد Max Physical Replication Lag.
بالنسبة إلى Aggregation الخاص بك، حدد Max.

قراءة مقياس تأخر النسخة المتماثلة

يعرض مقياس Read Replica Lag الوقت منذ آخر معاملة تمت إعادة تشغيلها على نسخة متماثلة. إذا لم تحدث أي معاملات على الأساسي الخاص بك، فإن المقياس يعكس هذا التأخير الزمني. على سبيل المثال، إذا لم تحدث أي معاملات على الخادم الأساسي الخاص بك، وتم إعادة تشغيل المعاملة الأخيرة قبل 5 ثوان، فعندئذ يعرض Read Replica Lag تأخيرا لمدة 5 ثوان.

في مدخل Microsoft Azure، حدد قراءة النسخة المتماثلة.
حدد القياسات. في نافذة Metrics ، حدد Read Replica Lag.
بالنسبة إلى Aggregation الخاص بك، حدد Max.

قراءة النسخ المتماثلة في قاعدة بيانات Azure ل PostgreSQL - خادم مرن

مشاركة عبر

إنشاء وإدارة النسخ المتماثلة للقراءة في قاعدة بيانات Azure ل PostgreSQL - خادم مرن من مدخل Microsoft Azure أو CLI أو واجهة برمجة تطبيقات REST

المتطلبات الأساسية

مراجعة الإعدادات الأساسية

إنشاء نسخة متماثلة للقراءة

إنشاء نقاط نهاية ظاهرية

سرد نقاط النهاية الظاهرية

تعديل التطبيق للإشارة إلى نقطة النهاية الظاهرية

ترقية النسخ المتماثلة

اختبار التطبيقات

إرجاع الموارد إلى الخادم والمنطقة الأصليين

اختبار التطبيقات

إضافة نسخة متماثلة للقراءة الثانوية

تعديل نقطة النهاية الظاهرية

ترقية النسخة المتماثلة إلى خادم مستقل

حذف نقطة النهاية الظاهرية

حذف نسخة متماثلة

حذف خادم أساسي

مراقبة نسخة متماثلة

الحد الأقصى لتأخر النسخ المتماثل الفعلي

قراءة مقياس تأخر النسخة المتماثلة

الملاحظات

الموارد الإضافية

مشاركة عبر

إنشاء وإدارة النسخ المتماثلة للقراءة في قاعدة بيانات Azure ل PostgreSQL - خادم مرن من مدخل Microsoft Azure أو CLI أو واجهة برمجة تطبيقات REST

المتطلبات الأساسية

مراجعة الإعدادات الأساسية

إنشاء نسخة متماثلة للقراءة

إنشاء نقاط نهاية ظاهرية

سرد نقاط النهاية الظاهرية

تعديل التطبيق للإشارة إلى نقطة النهاية الظاهرية

ترقية النسخ المتماثلة

اختبار التطبيقات

إرجاع الموارد إلى الخادم والمنطقة الأصليين

اختبار التطبيقات

إضافة نسخة متماثلة للقراءة الثانوية

تعديل نقطة النهاية الظاهرية

ترقية النسخة المتماثلة إلى خادم مستقل

حذف نقطة النهاية الظاهرية

حذف نسخة متماثلة

حذف خادم أساسي

مراقبة نسخة متماثلة

الحد الأقصى لتأخر النسخ المتماثل الفعلي

قراءة مقياس تأخر النسخة المتماثلة

المحتوى ذو الصلة

الملاحظات

الموارد الإضافية