Használd a REST API-t több adatbázis közötti adatok szinkronizálására

A következőkre vonatkozik:Azure SQL Database

Important

Az SQL adatszinkronizálás 2027. szeptember 30-án vonul vissza. Fontold meg alternatív adatreplikációs és szinkronizációs megoldásokra való áthelyezést. A nyugdíjazási folyamat részeként nem lehet új szinkroncsoportokat létrehozni Azure előfizetésekben, amelyek korábban nem használták az SQL adatszinkronizálás-et. A meglévő szinkroncsoportok a nyugdíjazási dátumig működhetnek, de ezeket a dátum előtt át kell migrálni egy alternatív megoldásra.

Ez a REST API példa az SQL adatszinkronizálás-et konfigurálja, hogy több adatbázis között szinkronizálja az adatokat.

Az SQL adatszinkronizálás áttekintését lásd: Mi az Azure SQL adatszinkronizálás?

Az SQL adatszinkronizálás nem támogatja a felügyelt Azure SQL-példányt vagy az Azure Synapse Analyticset.

Szinkronizálási csoport létrehozása

Használd a létrehozás vagy frissítés sablont szinkron csoport létrehozásához.

Szinkroncsoport létrehozásakor ne add át a szinkron sémát (táblázat\oszlop), és ne add masterSyncMemberNamebe , mert a szinkron csoport nem tartalmaz táblázat/oszlop információt.

A szinkron csoportnevek nem tartalmazhatnak speciális karaktereket, de tartalmazhatnak betűket, számokat, aláhúzást (_), jelet (-).

A csoportos szinkronizáció minimális intervallumideje öt másodperc. Ha az intervallum kisebb, öt másodpercet használnak fel.

Mintakérés egy szinkroncsoport létrehozására:

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187?api-version=2015-05-01-preview

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser"
  }
}

Mintaválasz egy szinkroncsoport létrehozásához:

Állapotkód: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Állapotkód: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Hozz létre szinkron tagot

Használd a létrehozás vagy frissítés sablont szinkron tag létrehozásához.

Mintakérés egy szinkron tag létrehozására:

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncgroupcrud-4879?api-version=2015-05-01-preview

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned"
  }
}

Mintaválasz egy szinkron tag létrehozásához:

Státuszkód:200

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncgroupcrud-4879",
  "name": "syncgroupcrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Státuszkód:201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncgroupcrud-4879",
  "name": "syncgroupcrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Séma frissítése

Miután sikeresen létrehozta a szinkroncsoportot, frissítse a sémát a következő sablonokkal.

Használd a refresh hub séma sablont a hub adatbázis sémájának frissítéséhez.

Példakérés egy hub adatbázis séma frissítésére:

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/refreshHubSchema?api-version=2015-05-01-preview

Mintaválasz egy hub adatbázis séma frissítéséhez:

Állapotkód: 200

Állapotkód: 202

Használd a list hub séma sablont a hub adatbázis sémájának felsorolásához.

Használd a refresh tag séma sablont a tag adatbázis séma frissítéséhez.

Használd a lista tag séma sablont a tag adatbázis sémájának listázásához.

Csak akkor lépj tovább a következő lépésre, ha a sémád sikeresen frissül.

Frissítse a szinkron csoportot

Használd a létrehozás vagy frissítés sablont a szinkronizáló csoportod frissítéséhez.

Frissítsd a szinkroncsoportot a szinkron séma megadásával. Add meg a sémát és a(z) masterSyncMemberName értéket, amely annak a névnek felel meg, amely a használni kívánt sémát tartalmazza.

Példakérés a szinkronizálási csoport frissítésére:

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187?api-version=2015-05-01-preview

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser"
  }
}

Mintaválasz a szinkronizáló csoport frissítéséhez:

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Szinkronizálási tag frissítése

Használd a create or update sablont a szinkronizáló tag frissítéséhez.

Példakérés egy szinkronizáló tag frissítésére:

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncgroupcrud-4879?api-version=2015-05-01-preview

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned"
  }
}

Mintaválasz egy szinkron tag frissítéséhez:

Állapotkód: 200

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncgroupcrud-4879",
  "name": "syncgroupcrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Állapotkód: 201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncgroupcrud-4879",
  "name": "syncgroupcrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Szinkronizálás indítása

Használd a trigger sync sablont a szinkron művelet elindításához.

Mintakérés a szinkronizálási művelet aktiválásához:

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/triggerSync?api-version=2015-05-01-preview

Mintaválasz a szinkronizálási művelet aktiválásához:

Állapotkód: 200

Kapcsolódó tartalom

Az Azure PowerShellről további információt az Azure PowerShell dokumentációjában talál.

További SQL Database PowerShell-szkriptminták találhatók az Azure SQL Database PowerShell-szkriptjeiben.

Az SQL adatszinkronizálás szolgáltatással kapcsolatos további információkért lásd:

• Áttekintés – Adatok szinkronizálása több felhőbeli és helyszíni adatbázison az Azure-beli SQL adatszinkronizálástel
• Adatszinkronizálás beállítása
  • Az Azure Portal használata – Oktatóanyag: Az SQL adatszinkronizálás beállítása az Adatok szinkronizálása az Azure SQL Database és az SQL Server között
  • A PowerShell használata – Adatok szinkronizálása az Azure SQL Database és az SQL Server adatbázisai között a PowerShell használatával
• Adatszinkronizálási ügynök – Adatszinkronizálási ügynök az Azure-beli SQL adatszinkronizáláshez
• Ajánlott eljárások – Ajánlott eljárások az SQL adatszinkronizáláshez az Azure-ban
• Monitor – Az SQL adatszinkronizálás monitorozása Azure Monitor-naplókkal
• Hibaelhárítás – Az AZURE-beli SQL adatszinkronizálástel kapcsolatos problémák elhárítása

További információ az SQL Database-ről:

• Az SQL Database áttekintése
• adatbázis életciklus-kezelési