Partager via


Stop-AzureSqlDatabaseCopy

Met fin à une relation de copie continue.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Stop-AzureSqlDatabaseCopy
    -ServerName <String>
    -DatabaseCopy <DatabaseCopy>
    [-ForcedTermination]
    [-Force]
    [-Profile <AzureSMProfile>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzureSqlDatabaseCopy
    -ServerName <String>
    -Database <Database>
    [-PartnerServer <String>]
    [-PartnerDatabase <String>]
    [-ForcedTermination]
    [-Force]
    [-Profile <AzureSMProfile>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-AzureSqlDatabaseCopy
    -ServerName <String>
    -DatabaseName <String>
    [-PartnerServer <String>]
    [-PartnerDatabase <String>]
    [-ForcedTermination]
    [-Force]
    [-Profile <AzureSMProfile>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Stop-AzureSqlDatabaseCopy met fin à une relation de copie continue. Cette applet de commande arrête le déplacement des données entre la base de données source et la base de données secondaire ou cible, puis modifie l’état de la base de données secondaire pour qu’elle soit une base de données en ligne autonome.

Il existe deux façons de mettre fin à une relation de copie continue, d’arrêter ou d’arrêter planifiée et d’arrêter forcée avec une perte de données possible. Sur le serveur qui héberge la base de données source, vous pouvez exécuter cette applet de commande en mode arrêt ou arrêt forcé. Sur le serveur qui héberge la base de données secondaire, vous devez utiliser le mode d’arrêt forcé.

Un arrêt planifié attend que toutes les transactions validées sur la base de données source, au moment où vous exécutez l’applet de commande, aient été répliquées vers la base de données secondaire. L’arrêt forcé n’attend pas la réplication des transactions validées en attente et peut entraîner une perte de données possible dans la base de données secondaire.

Bien que l’état de la réplication soit EN ATTENTE, seule l’arrêt forcé peut mettre fin à une relation de copie continue. Si l’état de réplication est EN ATTENTE, l’arrêt qui n’est pas forcé n’est pas pris en charge.

Exemples

Exemple 1 : Arrêter une relation de copie continue

PS C:\>Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"

Cette commande met fin à la relation de copie continue de la base de données nommée Orders sur le serveur nommé lpqd0zbr8y. Le serveur nommé bk0b8kf658 héberge la base de données secondaire.

Exemple 2 : Mettre fin de force à une relation de copie continue

PS C:\>$DatabaseCopy = Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders"
PS C:\> $DatabaseCopy | Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -ForcedTermination

La première commande obtient la relation de copie de base de données pour la base de données nommée Orders sur le serveur nommé lpqd0zbr8y.

La deuxième commande met fin à une relation de copie continue à partir du serveur qui héberge la base de données secondaire.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Database

Spécifie un objet qui représente la source Azure SQL Database. Cette applet de commande met fin à la relation de copie continue de la base de données spécifiée par ce paramètre.

Type:Database
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DatabaseCopy

Spécifie un objet qui représente une base de données. Cette applet de commande met fin à la relation de copie continue de la base de données spécifiée par ce paramètre. Ce paramètre accepte l’entrée de pipeline.

Type:DatabaseCopy
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DatabaseName

Spécifie le nom d’une base de données. Cette applet de commande met fin à la relation de copie continue de la base de données spécifiée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForcedTermination

Indique que cette applet de commande provoque l’arrêt forcé de la relation de copie continue. L’arrêt forcé peut entraîner une perte de données. Pour exécuter cette applet de commande sur un serveur qui héberge la base de données cible, vous devez spécifier ce paramètre. Pour exécuter cette applet de commande sur un serveur qui héberge la base de données source, si la base de données secondaire n’est pas disponible, vous devez spécifier ce paramètre.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PartnerDatabase

Spécifie le nom de la base de données secondaire. Si vous spécifiez un nom, il doit correspondre au nom de la base de données source.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PartnerServer

Spécifie le nom du serveur qui héberge la base de données cible.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerName

Spécifie le nom du serveur sur lequel réside la base de données source.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Sorties

None

Notes

  • Authentification : cette applet de commande nécessite une authentification basée sur des certificats. Pour obtenir un exemple d’utilisation de l’authentification basée sur un certificat pour définir l’abonnement actuel, consultez l’applet de commande New-AzureSqlDatabaseServerContext .

  • Restrictions : sur le serveur qui héberge la base de données secondaire, seul l’arrêt forcé est pris en charge.

  • Impact de l’arrêt sur l’ancienne base de données secondaire : après l’arrêt, la base de données secondaire devient une base de données indépendante. Si l’amorçage est déjà terminé sur la base de données secondaire, une fois cette base de données terminée, est ouverte pour un accès total. Si la base de données source est une base de données en lecture-écriture, l’ancienne base de données secondaire devient également une base de données en lecture-écriture.

    Si l’amorçage est en cours, l’amorçage est abandonné et l’ancienne base de données secondaire ne devient jamais visible sur le serveur qui héberge la base de données secondaire.

  • Vous pouvez définir la base de données source en mode lecture seule. Cela garantit que les bases de données sources et secondaires sont synchronisées après l’arrêt, et vérifient qu’aucune transaction n’est validée lors de l’arrêt. Une fois l’arrêt terminé, définissez la source sur le mode lecture-écriture. Si vous le souhaitez, vous pouvez également définir l’ancienne base de données secondaire en mode lecture-écriture.

  • Surveillance : Pour vérifier l’état des opérations à la fois à la source et à la cible de la relation de copie continue, utilisez l’applet de commande Get-AzureSqlDatabaseOperation .