Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
Azure SQL Database
Important
SQL Synchronisation des données prend sa retraite le 30 septembre 2027. Envisagez de migrer vers des solutions alternatives de réplication et de synchronisation des données. Dans le cadre du processus de retraite, vous ne pouvez pas créer de nouveaux groupes de synchronisation dans les abonnements Azure qui n'utilisaient pas auparavant SQL Synchronisation des données. Les groupes de synchronisation existants peuvent continuer à fonctionner jusqu'à la date de départ à la retraite, mais vous devriez les migrer vers une solution alternative avant cette date.
Cet exemple d’API REST configure SQL Synchronisation des données pour la synchronisation des données entre plusieurs bases de données.
Pour une vue d’ensemble de SQL Synchronisation des données, consultez la Présentation de SQL Data Sync pour Azure.
Azure SQL Synchronisation des données ne prend pas en charge Azure SQL Managed Instance ou Azure Synapse Analytics.
Créer un groupe de synchronisation
Utilisez le modèle Créer ou mettre à jour pour créer un groupe de synchronisation.
Lorsque vous créez un groupe de synchronisation, ne transmettez ni le schéma de synchronisation (table\colonne) ni masterSyncMemberName, car un groupe de synchronisation ne contient pas d’informations sur la table\colonne.
Les noms de groupes de synchronisation ne peuvent pas contenir de caractères spéciaux, mais peuvent contenir des lettres, des chiffres, un trait de soulignement (_), un tiret (-).
La durée minimale de la synchronisation de groupe est de cinq secondes. Si le temps d’intervalle est plus petit, cinq secondes seront utilisées.
Exemple de demande pour la création d’un groupe de synchronisation :
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"
}
}
Exemple de réponse pour la création d’un groupe de synchronisation :
Code d’état : 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"
}
Code d’état : 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"
}
Créer un membre de synchronisation
Utilisez le modèle Créer ou mettre à jour pour créer un membre de synchronisation.
Exemple de demande pour la création d’un membre de synchronisation :
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"
}
}
Exemple de réponse pour la création d’un membre de synchronisation :
Code d’état : 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"
}
Code d’état : 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"
}
Actualiser le schéma
Une fois que votre groupe de synchronisation est correctement créé, actualisez le schéma à l’aide des modèles suivants.
Utilisez le modèle Actualiser le schéma du hub pour actualiser le schéma de la base de données Hub.
Exemple de demande pour l’actualisation d’un schéma de base de données Hub :
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
Exemple de réponse pour l’actualisation d’un schéma de base de données Hub :
Code d’état : 200
Code d’état : 202
Utilisez le modèle Lister les schémas du hub pour lister le schéma de la base de données Hub.
Utilisez le modèle Actualiser le schéma du membre pour actualiser le schéma de la base de données membre.
Utilisez le modèle list member schema pour répertorier le schéma de base de données du membre.
Passez à l’étape suivante seulement si votre schéma a été actualisé avec succès.
Mettre à jour un groupe de synchronisation
Utilisez le modèle Créer ou mettre à jour pour mettre à jour votre groupe de synchronisation.
Mettez à jour le groupe de synchronisation en spécifiant le schéma de synchronisation. Incluez votre schéma et masterSyncMemberName, qui est le nom contenant le schéma à utiliser.
Exemple de demande pour la mise à jour du groupe de synchronisation :
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"
}
}
Exemple de réponse pour la mise à jour du groupe de synchronisation :
{
"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"
}
Mettre à jour le membre de synchronisation
Utilisez le modèle Créer ou mettre à jour pour mettre à jour votre membre de synchronisation.
Exemple de demande pour la mise à jour d’un membre de synchronisation :
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"
}
}
Exemple de réponse pour la mise à jour d’un membre de synchronisation :
Code d’état : 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"
}
Code d’état : 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"
}
Déclencher une synchronisation
Utilisez le modèle Déclencher une synchronisation pour déclencher une opération de synchronisation.
Exemple de demande pour le déclenchement d’une opération de synchronisation :
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
Exemple de réponse pour le déclenchement d’une opération de synchronisation :
Code d’état : 200
Contenu connexe
Pour plus d’informations sur Azure PowerShell, consultez la documentation d’Azure PowerShell.
Vous trouverez des exemples supplémentaires de scripts SQL Database PowerShell sur la page Scripts PowerShell Azure SQL Database.
Pour plus d’informations sur SQL Synchronisation des données, consultez :
- Vue d’ensemble - Synchroniser des données entre plusieurs bases de données cloud et locales avec SQL Synchronisation des données dans Azure
- Configuration de la synchronisation des données
- Synchronisation des données Agent - Synchronisation des données Agent pour SQL Synchronisation des données dans Azure
- Bonnes pratiques - Bonnes pratiques pour SQL Synchronisation des données dans Azure
- Supervision – Superviser SQL Synchronisation des données avec les journaux d’activité Azure Monitor
- Résolution des problèmes - Résoudre les problèmes liés à SQL Synchronisation des données dans Azure
Pour plus d’informations sur SQL Database, consultez :