Använd REST API för att synkronisera data mellan flera databaser

Important

SQL Data Sync går i pension den 30 september 2027. Överväg att migrera till alternativa lösningar för datareplikering och synkronisering. Som en del av avgångsprocessen kan du inte skapa nya synkroniseringsgrupper i Azure-prenumerationer som inte tidigare använde SQL Data Sync. Befintliga synkroniseringsgrupper kan fortsätta fungera fram till pensionsdatumet, men du bör migrera dem till en alternativ lösning innan det datumet.

Detta REST API-exempel konfigurerar SQL Data Sync för att synkronisera data mellan flera databaser.

En översikt över SQL Data Sync finns i Vad är SQL Data Sync för Azure?

SQL Data Sync stöder inte Azure SQL Managed Instance eller Azure Synapse Analytics.

Skapa synkroniseringsgrupp

Använd mallen för skapa eller uppdatera för att skapa en synkgrupp.

När du skapar en synkroniseringsgrupp, skicka inte in synkroniseringsschemat (tabell\kolumn) och skicka inte in masterSyncMemberName, eftersom synkroniseringsgruppen inte har tabell/kolumn-information.

Synkroniseringsgruppnamn kan inte innehålla specialtecken, men kan innehålla bokstäver, siffror, understreck (_), bindestreck (-).

Den minsta intervalltiden för gruppsynkronisering är fem sekunder. Om intervalltiden är kortare används fem sekunder.

Exempelförfrågan för att skapa en synkgrupp:

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"
  }
}

Exempelsvar för att skapa en synkgrupp:

Statuskod: 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"
}

Statuskod: 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"
}

Skapa synkmedlem

Använd mallen för skapa eller uppdatera för att skapa en synkmedlem.

Exempelförfrågan för att skapa en synkmedlem:

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"
  }
}

Exempelsvar för att skapa en synkmedlem:

Statuskod: 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"
}

Statuskod: 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"
}

Uppdatera schema

När din synkroniseringsgrupp har skapats framgångsrikt, uppdatera schemat med följande mallar.

Använd refresh hub-schemamallen för att uppdatera schemat för hubdatabasen.

Exempelförfrågan för att uppdatera ett hubbdatabasschema:

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

Exempelsvar för att uppdatera ett hubbdatabasschema:

Statuskod: 200

Statuskod: 202

Använd mallen för lista hub-scheman för att lista databasschemat.

Använd mallen för att uppdatera medlemschemat för att uppdatera medlemsdatabasens schema.

Använd mallen schemat för listmedlemmar för att visa medlemsdatabasschemat.

Gå bara vidare till nästa steg när ditt schema uppdateras framgångsrikt.

Uppdatera synkroniseringsgrupp

Använd mallen för att skapa eller uppdatera för att uppdatera din synkroniseringsgrupp.

Uppdatera synkroniseringsgruppen genom att ange synkroniseringsschemat. Inkludera ditt schema och masterSyncMemberName, vilket är namnet som innehåller det schema du vill använda.

Exempelförfrågan för att uppdatera synkroniseringsgruppen:

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"
  }
}

Exempelsvar för att uppdatera synkroniseringsgruppen:

{
  "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"
}

Uppdatera synkmedlem

Använd mallen för skapa eller uppdatera för att uppdatera din synkroniseringsmedlem.

Exempelförfrågan för att uppdatera en synkroniseringsmedlem:

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"
  }
}

Exempelsvar för att uppdatera en synkroniseringsmedlem:

Statuskod: 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"
}

Statuskod: 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"
}

Utlösa synkronisering

Använd trigger sync-mallen för att trigga en synkroniseringsoperation.

Exempelförfrågan för att trigga synkoperation:

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

Exempelrespons för att trigga synkroniseringsoperation:

Statuskod: 200

Mer information om Azure PowerShell finns i Azure PowerShell-dokumentation.

Ytterligare POWERShell-skriptexempel för SQL Database finns i Azure SQL Database PowerShell-skript.

Mer information om SQL Data Sync finns i:

Översikt – Synkronisera data över flera molndatabaser och lokala databaser med SQL Data Sync i Azure
Konfigurera datasynkronisering
- Använda Azure-portalen – Självstudie: Konfigurera SQL Data Sync för att synkronisera data mellan Azure SQL Database och SQL Server
- Använda PowerShell – Använda PowerShell för att synkronisera data mellan en databas i Azure SQL Database och SQL Server
Data Sync Agent – Data Sync Agent för SQL Data Sync i Azure
Metodtips – metodtips för SQL Data Sync i Azure
Övervaka – Övervaka SQL Data Sync med Azure Monitor-loggar
Felsökning – Felsöka problem med SQL Data Sync i Azure

Mer information om SQL Database finns i:

översikt över SQL Database
Livscykelhantering för databaser

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-09-08

Använd REST API för att synkronisera data mellan flera databaser

Skapa synkroniseringsgrupp

Skapa synkmedlem

Uppdatera schema

Uppdatera synkroniseringsgrupp

Uppdatera synkmedlem

Utlösa synkronisering

Relaterat innehåll

Feedback

Ytterligare resurser