Gebruik de REST API om data te synchroniseren tussen meerdere databases

Van toepassing op:Azure SQL Database

Important

SQL Data Sync gaat op 30 september 2027 met pensioen. Overweeg te migreren naar alternatieve oplossingen voor data-replicatie en -synchronisatie. Als onderdeel van het pensioenproces kun je geen nieuwe synchronisatiegroepen aanmaken in Azure-abonnementen die eerder geen SQL Data Sync gebruikten. Bestaande synchronisatiegroepen kunnen blijven werken tot de pensioendatum, maar je moet ze vóór die datum migreren naar een alternatieve oplossing.

Dit REST API-voorbeeld configureert SQL Data Sync om data tussen meerdere databases te synchroniseren.

Voor een overzicht van SQL Data Sync, zie Wat is SQL Data Sync voor Azure?

SQL Data Sync biedt geen ondersteuning voor Azure SQL Managed Instance of Azure Synapse Analytics.

Synchronisatiegroep maken

Gebruik het sjabloon voor aanmaken of bijwerken om een synchronisatiegroep aan te maken.

Bij het maken van een synchronisatiegroep geef je het synchronisatieschema (tabel\kolom) niet door en geef je masterSyncMemberName ook niet door, omdat de synchronisatiegroep geen tabel\kolom-informatie heeft.

Synchronisatiegroepnamen kunnen geen speciale tekens bevatten, maar wel letters, cijfers, onderstrepen (_), streepje (-).

De minimale intervaltijd voor groepssynchronisatie is vijf seconden. Als de intervaltijd korter is, wordt er vijf seconden gebruikt.

Voorbeeldverzoek voor het aanmaken van een synchronisatiegroep:

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

Voorbeeldantwoord voor het aanmaken van een synchronisatiegroep:

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

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

Maak synchronisatielid aan

Gebruik het sjabloon voor aanmaken of bijwerken om een sync-lid te maken.

Voorbeeldverzoek voor het aanmaken van een synchronisatielid:

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

Voorbeeldantwoord voor het aanmaken van een synchronisatielid:

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

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

Schema vernieuwen

Zodra je synchronisatiegroep succesvol is aangemaakt, vernieuw je het schema met de volgende sjablonen.

Gebruik het refresh hub schema template om het schema voor de hub-database te verversen.

Voorbeeldverzoek voor het verversen van een hubdatabaseschema:

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

Voorbeeldrespons voor het verversen van een hubdatabaseschema:

Statuscode: 200

Statuscode: 202

Gebruik de lijst hub schema's sjabloon om het hub-databaseschema te vermelden.

Gebruik het sjabloon voor het verversen van het lidschema om het ledendatabaseschema te versen.

Gebruik het lijstlidschema-sjabloon om het databaseschema van leden te vermelden.

Ga pas verder naar de volgende stap nadat je schema succesvol is ververst.

Synchronisatiegroep bijwerken

Gebruik de create- of update-template om je sync-groep bij te werken.

Werk de synchronisatiegroep bij door het synchronisatieschema te specificeren. Voeg je schema en masterSyncMemberName, wat de naam is die het schema bevat dat je wilt gebruiken.

Voorbeeldverzoek voor het updaten van de synchronisatiegroep:

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

Voorbeeldrespons voor het updaten van de synchronisatiegroep:

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

Synchronisatielid bijwerken

Gebruik het sjabloon voor aanmaken of bijwerken om je sync-lid bij te werken.

Voorbeeldverzoek voor het updaten van een sync-lid:

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

Voorbeeldreactie voor het bijwerken van een synchronisatielid:

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

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

Synchronisatie activeren

Gebruik de trigger sync template om een sync-operatie te starten.

Voorbeeldverzoek voor het triggeren van synchronisatieoperatie:

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

Voorbeeldrespons voor het triggeren van synchronisatie-operatie:

Statuscode: 200

Zie de Documentatie voor Azure PowerShell voor meer informatie over Azure PowerShell.

Aanvullende voorbeelden van SQL Database PowerShell-scripts vindt u in Azure SQL Database PowerShell-scripts.

Zie voor meer informatie over SQL Data Sync:

Overzicht: gegevens synchroniseren tussen meerdere cloud- en on-premises databases met SQL Data Sync in Azure
Data Sync instellen
- Azure Portal - Zelfstudie: SQL Data Sync instellen om gegevens te synchroniseren tussen Azure SQL Database en SQL Server
- PowerShell gebruiken - PowerShell gebruiken om gegevens te synchroniseren tussen een database in Azure SQL Database en SQL Server
Data Sync Agent - Data Sync Agent voor SQL Data Sync in Azure
Beste praktijken - Beste praktijken voor SQL Data Sync in Azure
Controleren - SQL Data Sync controleren met Azure Monitor-logboeken
Problemen met SQL Data Sync in Azure oplossen

Zie voor meer informatie over SQL Database:

Feedback

Is deze pagina nuttig?

Last updated on 2026-09-08

Gebruik de REST API om data te synchroniseren tussen meerdere databases

Synchronisatiegroep maken

Maak synchronisatielid aan

Schema vernieuwen

Synchronisatiegroep bijwerken

Synchronisatielid bijwerken

Synchronisatie activeren

Verwante onderwerpen

Feedback

Aanvullende resources