Stop-AzureSqlDatabaseCopy

  • Référence
Module:
Azure

Met fin à une relation de copie continue.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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 l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServer

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .