

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Journaux d'écriture anticipée (WAL) pour Amazon EMR
<a name="emr-hbase-wal"></a>

Avec Amazon EMR 6.15 et versions ultérieures, vous pouvez écrire vos journaux d' HBase écriture anticipée (WAL) Apache sur le WAL Amazon EMR. Dans les versions inférieures d'Amazon EMR, lorsque vous créez un cluster avec l'option **HBase sur Amazon S3**, WAL est le seul HBase composant Apache stocké sur le disque local pour les clusters, et vous pouvez stocker d'autres composants tels que le répertoire racine, les fichiers de stockage (HFiles), les métadonnées des tables et les données sur Amazon S3.

Vous pouvez utiliser Amazon EMR WAL pour récupérer des données qui n'ont pas été transférées vers Amazon S3. Pour sauvegarder l'intégralité de vos HBase clusters, choisissez d'utiliser le service Amazon EMR WAL. En arrière-plan, `RegionServer` écrit vos journaux d' HBase écriture anticipée (WAL) dans le WAL pour Amazon EMR.

Si votre cluster ou l'AZ ne fonctionne pas correctement ou n'est plus disponible, vous pouvez créer un nouveau cluster, le pointer vers le même répertoire racine S3 et le même espace de travail Amazon EMR WAL, et récupérer automatiquement les données dans WAL en quelques minutes. Pour de plus amples informations, veuillez consulter [Restauration depuis Amazon EMR WAL](emr-hbase-wal-restoring.md).

À partir des versions 7.3.0 et supérieures d'Amazon EMR, Amazon EMR crée plusieurs EMR pour chaque serveur et regroupe plusieurs régions HBase dans un seul Amazon WALs EMR WAL. Cela permet d'améliorer Apache HBase WAL afin d'améliorer l'utilisation des journaux et d'optimiser les coûts. Pour configurer le nombre d'instances Amazon EMR WAL par HBase `RegionServer`, utilisez le paramètre. `hbase.wal.regiongrouping.numgroups` Par défaut, ce paramètre est défini sur 2. Il existe deux tables système qui ne sont incluses dans aucun groupe WAL : *meta* et *masterstore*. Ces tables utilisent toujours leur propre individualité WALs. 

Si vous utilisez une version inférieure à Amazon EMR 7.3.0, nous vous recommandons de désactiver manuellement les tables de l'ancien HBase cluster pour vous assurer que toutes les données du WAL Amazon EMR sont transférées vers Amazon S3. Supprimez ensuite l'ancien Amazon EMR WAL, mettez fin à l'ancien cluster et configurez un nouveau cluster qui exécute la dernière version. Si vous rencontrez des problèmes et que vous ne parvenez pas à désactiver les tables de l'ancien cluster, vous pouvez directement arrêter l'ancien cluster et `emr.wal.multiplex.migrate` définir sur`true`. sur le nouveau cluster. S'il est défini sur true, il HBase essaiera de rejouer les données des anciennes instances Amazon EMR WAL HBase lors de l'initialisation de la région et de supprimer les anciennes après la WALs rediffusion. Ce processus de rediffusion entraîne des coûts supplémentaires pour les lectures. Après la migration, nous vous recommandons de configurer le cluster et de le `emr.wal.multiplex.migrate` définir sur`false`. Vous pouvez également supprimer le paramètre pour accélérer l'initialisation de HBase la région.

**Note**  
 Amazon EMR WAL supprime les données après HBase les avoir vidées. Si les données HBase ne sont pas supprimées, Amazon EMR WAL les conserve pendant une durée maximale de 30 jours. Après 30 jours, Amazon EMR WAL supprime automatiquement les données. Amazon EMR conserve les instances WAL jusqu'à 30 jours à compter de la résiliation d'un cluster EMR. Toutefois, si vous lancez un nouveau cluster compatible WAL depuis le même répertoire racine S3 au cours de ces 30 jours, Amazon EMR ne supprimera aucune des instances WAL de votre cluster précédent. Pour de plus amples informations, veuillez consulter [Restauration depuis Amazon EMR WAL](emr-hbase-wal-restoring.md).

Les sections suivantes décrivent comment configurer et utiliser Amazon EMR WAL avec votre cluster EMR HBase activé.

**Topics**
+ [Espaces de travail Amazon EMR WAL](emr-hbase-wal-workspaces.md)
+ [Autorisations requises pour Amazon EMR WAL](emr-hbase-wal-permissions.md)
+ [Activation d'Amazon EMR WAL](emr-hbase-wal-enabling.md)
+ [Restauration depuis Amazon EMR WAL](emr-hbase-wal-restoring.md)
+ [Utilisation de configurations de sécurité avec Amazon EMR WAL](emr-hbase-wal-security.md)
+ [Accédez à Amazon EMR WAL via AWS PrivateLink](emr-hbase-wal-privatelink.md)
+ [Comprendre la tarification et les statistiques d'Amazon EMR WAL](emr-hbase-wal-metrics.md)
+ [Marquage des espaces de travail WAL](emr-hbase-wal-tagging.md)
+ [Réplication entre clusters EMR WAL](emr-hbase-wal-cross-cluster.md)
+ [Considérations et régions relatives à Amazon EMR WAL](emr-hbase-wal-considerations.md)
+ [Référence de la EMRWAL CLI Amazon EMR WAL ()](emrwalcli-ref.md)

# Espaces de travail Amazon EMR WAL
<a name="emr-hbase-wal-workspaces"></a>

Amazon EMR WAL ajoute le concept d'espaces de travail WAL. Un *espace de travail WAL* est un conteneur logique de WALs. Chaque journal d'écriture anticipée dans Amazon EMR WAL est encapsulé par un espace de travail WAL. Un cluster EMR écrit dans exactement un espace WALs de travail WAL que vous configurez au lancement du cluster, ou dans le `defaultWALworkspace` si vous ne spécifiez aucun espace de travail. Les espaces de travail WAL ne sont liés à aucune HBase terminologie existante telle que les espaces de noms.

Vous pouvez utiliser les espaces de travail WAL pour limiter les autorisations Amazon EMR WAL IAM afin d'inclure uniquement les espaces de travail auxquels le cluster doit accéder. Vous pouvez également étiqueter votre espace de travail WAL pour un contrôle d'accès basé sur des balises. Pour plus d'informations sur le balisage, consultez[Marquage des espaces de travail WAL](emr-hbase-wal-tagging.md).

![\[HBase architecture diagram showing write request flow through RegionServers, MemStore, and data storage.\]](http://docs.aws.amazon.com/fr_fr/emr/latest/ReleaseGuide/images/wal-new.png)


# Autorisations requises pour Amazon EMR WAL
<a name="emr-hbase-wal-permissions"></a>

Pour que votre cluster puisse se connecter à Amazon EMR WAL, le profil d'instance du cluster nécessite certaines autorisations IAM :
+ Amazon EMR WAL utilise le rôle [https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html)lié au service pour récupérer l'état d'un cluster. Amazon EMR crée automatiquement ce rôle lié au service lorsque vous créez un espace de travail WAL, ou HBase créera le rôle lié au service lorsque vous configurez un espace de travail pour Amazon EMR WAL et que le rôle lié au service n'existe pas encore.

  Avant de pouvoir activer Amazon EMR WAL pour un cluster, vous devez configurer les autorisations pour permettre la création automatique du rôle lié au AWSServiceRoleForEMRWAL service. Pour plus d'informations et un exemple d'instruction qui ajoute cette fonctionnalité, consultez la section [Utilisation de rôles liés à un service pour la journalisation en écriture anticipée](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html#using-service-linked-roles-permissions-wal).
+ Dans la mesure où Amazon EMR WAL utilise le HBase Write Ahead Log (WAL), vos clusters doivent utiliser HBase le WAL. Voici les autorisations IAM minimales dont vous avez besoin pour exécuter HBase. Ajoutez les éléments suivants à la politique d'autorisation de votre profil d'instance :

  ```
  emrwal:DeleteWal
  emrwal:CreateWal
  emrwal:CreateWorkspace
  emrwal:AppendEdit
  emrwal:ReplayEdits
  emrwal:GetCurrentWalTime
  emrwal:CompleteWalFlush
  emrwal:ListWALs
  emrwal:DescribeWAL
  emrwal:TrimWAL
  emrwal:ArchiveWAL
  emrwal:ArchiveWALCheckPoint
  ```
**Note**  
Si vous limitez les autorisations pour Amazon EMR WAL à un ensemble minimal, certaines commandes [EMRWALCLI](emrwalcli-ref.md) ne disposeront pas des autorisations nécessaires pour s'exécuter.

# Activation d'Amazon EMR WAL
<a name="emr-hbase-wal-enabling"></a>

Suivez les étapes suivantes pour activer l'écriture sur le WAL Amazon EMR lorsque vous créez un cluster avec le. AWS Command Line Interface

**Note**  
Vous ne pouvez pas activer Amazon EMR WAL pour un cluster déjà en cours d'exécution, et vous ne pouvez pas lancer deux clusters avec le même répertoire racine S3. Pour de plus amples informations, veuillez consulter [Considérations et régions relatives à Amazon EMR WAL](emr-hbase-wal-considerations.md).

1. Avant de créer un cluster compatible Amazon EMR WAL, vous devez ajouter les autorisations requises au profil d'instance que vous prévoyez d'utiliser avec votre cluster. Pour de plus amples informations, veuillez consulter [Autorisations requises pour Amazon EMR WAL](emr-hbase-wal-permissions.md).

1. Créez un cluster à partir du AWS CLI. Utilisez `--configurations` cette option pour fournir un objet de configuration JSON qui spécifie la `hbase.emr.wal.enabled` propriété, comme illustré dans l'exemple ci-dessous.
   + Spécifiez le mode de stockage et l'emplacement du répertoire racine dans Amazon S3. L'emplacement Amazon S3 que vous spécifiez doit se trouver dans la même région que votre cluster EMR, mais un seul cluster actif peut utiliser le même répertoire HBase racine dans S3 à la fois.
   + Créez votre cluster avec la configuration des groupes d'instances. Vous ne pouvez pas utiliser Amazon EMR WAL avec la configuration des flottes d'instances. Pour plus d'informations sur la création de clusters avec des groupes d'instances, consultez [Configurer des groupes d'instances uniformes](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-uniform-instance-group.html) dans le *guide de gestion Amazon EMR.*
   + Pour connaître les étapes de création d'un cluster sur console, ainsi qu'un `create-cluster` exemple détaillé utilisant le AWS CLI, voir [Création d'un cluster avec HBase](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-create.html).

1. Pour activer WAL pour le nouveau cluster, définissez la `hbase.emr.wal.enabled` propriété sur`true`. La commande suivante contient un extrait de code JSON avec un exemple d'objet de configuration.

   ```
   aws emr create-cluster --name "hbasewal" --release-label emr-6.x.y \
   --applications Name=HBase --use-default-roles --ec2-attributes KeyName=myKey \
   --instance-type m6i.xlarge --instance-count 1 --configurations hbase.json
   $cat hbase.json
   [
       {
           "Classification": "hbase-site",
           "Properties": {
               "hbase.rootdir": "s3://amzn-s3-demo-bucket/MyHBaseStore"
           }
       },
       {
           "Classification": "hbase",
           "Properties": {
               "hbase.emr.storageMode": "s3",
               "hbase.emr.wal.enabled": "true"
           }
       }
   ]
   ```

Lorsqu'il HBase est en ligne sur le cluster nouvellement créé, il écrit HBase automatiquement les données WAL sur le Amazon EMR WAL et utilise le Amazon EMR WAL à des fins de restauration. 

**Example 1 : Création d'un cluster EMR utilisant Amazon EMR WAL**  

```
[
    {
        "Classification": "hbase-site",
        "Properties": {
            "hbase.rootdir": "s3://amzn-s3-demo-bucket/MyHBaseStore"
        }
    },
    {
        "Classification": "hbase",
        "Properties": {
            "hbase.emr.storageMode": "s3",
            "hbase.emr.wal.enabled": "true"
        }
    }
]
```

**Example 2 : Création d'un cluster EMR avec un espace de travail WAL personnalisé**  

```
[
    {
        "Classification": "hbase-site",
        "Properties": {
            "hbase.rootdir": "s3://amzn-s3-demo-bucket/MyHBaseStore",
            "emr.wal.workspace": "customWorkspaceName"
        }
    },
    {
        "Classification": "hbase",
        "Properties": {
            "hbase.emr.storageMode": "s3",
            "hbase.emr.wal.enabled": "true"
        }
    }
]
```

# Restauration depuis Amazon EMR WAL
<a name="emr-hbase-wal-restoring"></a>

Étant donné que le WAL Amazon EMR de votre cluster d'origine est conservé pendant 30 jours, vous pouvez restaurer et réutiliser le WAL pour un cluster nouvellement créé au cours de cette période de 30 jours. Lorsque vous lancez un nouveau cluster depuis le même répertoire racine S3, Amazon EMR conserve les instances WAL de votre ancien cluster. Si vous mettez fin à ce nouveau cluster, le délai de 30 jours redémarre à compter de la date de résiliation.

Utilisez la procédure suivante pour restaurer un WAL existant avec un nouveau cluster. Ce processus suppose que vous avez créé votre cluster d'origine avec Amazon EMR WAL activé.

1. Dans les 30 jours suivant la création d'un cluster compatible WAL, créez un nouveau cluster Région AWS identique au cluster d'origine. Le nouveau cluster peut se trouver dans la même AZ ou dans une autre AZ au sein de la même région que celle dans laquelle le cluster d'origine a été créé.

   Configurez les propriétés de l'objet pour spécifier le mode de stockage et l'emplacement du répertoire racine dans Amazon S3. L'emplacement Amazon S3 que vous spécifiez doit se trouver dans la même région que votre cluster EMR, mais un seul cluster actif peut utiliser le même répertoire HBase racine dans S3 à la fois.

   Pour connaître les étapes de création d'un cluster sur console, ainsi qu'un `create-cluster` exemple détaillé utilisant le AWS CLI, voir [Création d'un cluster avec HBase](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-create.html).

1. Pour utiliser le WAL Amazon EMR existant pour le nouveau cluster, définissez la `hbase.emr.wal.enabled` propriété sur. `true` L'extrait de code JSON suivant montre un exemple d'objet de configuration.

```
[
    {
        "Classification": "hbase-site",
        "Properties": {
            "hbase.rootdir": "s3://amzn-s3-demo-bucket/MyHBaseStore"
        }
    },
    {
        "Classification": "hbase",
        "Properties": {
            "hbase.emr.storageMode": "s3",
            "hbase.emr.wal.enabled": "true"
        }
    }
]
```

# Utilisation de configurations de sécurité avec Amazon EMR WAL
<a name="emr-hbase-wal-security"></a>

Amazon EMR chiffre automatiquement les données en transit entre votre cluster et le service Amazon EMR WAL, ainsi que les données au repos dans Amazon EMR WAL. Pour plus d'informations, consultez [Encryption at rest for Amazon EMR WAL.](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-data-encryption-options.html#emr-encryption-WAL) Vous pouvez également utiliser une configuration de sécurité pour importer vos propres clés depuis le service AWS Key Management Service (KMS) et chiffrer les données que vous stockez dans Amazon EMR WAL. 

Utilisez l'une des méthodes suivantes pour sélectionner une configuration de sécurité lorsque vous créez un cluster :

------
#### [ Console ]

À partir de AWS Management Console, spécifiez la configuration sous **Configuration de sécurité et paire de clés EC2**.

![\[Security configuration section with search bar, refresh button, and options to browse or create configuration.\]](http://docs.aws.amazon.com/fr_fr/emr/latest/ReleaseGuide/images/wal-configure-security.png)


------
#### [ CLI ]

À partir de AWS CLI, définissez le `--security-configuration` paramètre lorsque vous utilisez la commande [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html).

------

Pour plus d'informations, consultez les [sections Chiffrement au repos pour Amazon EMR WAL](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-data-encryption-options.html#emr-encryption-WAL) et [Utiliser les configurations de sécurité pour configurer la sécurité du cluster](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-security-configurations.html) dans le guide de gestion Amazon *EMR.*

Pour plus d'informations relatives à la sécurité sur WAL, consultez la section [Utilisation de rôles liés à un service pour la journalisation](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html) en écriture anticipée.

# Accédez à Amazon EMR WAL via AWS PrivateLink
<a name="emr-hbase-wal-privatelink"></a>

Si vous souhaitez conserver votre connexion au sein du AWS réseau, Amazon EMR WAL propose une AWS PrivateLink assistance. Pour le configurer AWS PrivateLink, utilisez le AWS Management Console ou AWS Command Line Interface (AWS CLI) pour créer un point de terminaison VPC d'interface qui se connecte à Amazon EMR WAL. *Pour plus d'informations, consultez la section [Accès à un AWS service à l'aide d'un point de terminaison VPC d'interface](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) dans le AWS PrivateLink Guide.*

La procédure de base est la suivante :

1. Utilisez la console Amazon VPC pour [créer un point de terminaison VPC.](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) Sélectionnez **Endpoints**, puis **Create endpoint**.

1. Conservez la catégorie Service en tant que **AWS services**.

1. Dans la barre de recherche du panneau **Services**, tapez**emrwal**, puis sélectionnez le service intitulé`com.amazonaws.region.emrwal.prod`.

1. Sélectionnez votre VPC et enregistrez le point de terminaison. Assurez-vous d'associer les mêmes groupes de sécurité au point de terminaison VPC que vous attachez au cluster EMR.

1. Si vous le souhaitez, vous pouvez désormais activer les noms d'hôte DNS privés pour votre nouveau point de terminaison. Définissez **Activer les noms d'hôte DNS** et **Activer le support DNS** sur `true` pour votre VPC. Sélectionnez ensuite votre identifiant de point de terminaison, choisissez **Modifier les paramètres VPC** dans le menu **Actions** et activez les noms DNS privés.
   + Les noms d'hôte DNS privés du point de terminaison suivront le format`prod.emrwal.region.amazonaws.com`.
   + Si vous n'activez pas les noms d'hôte DNS privés, Amazon VPC vous fournit un nom de point de terminaison DNS au format suivant. `endpointID.prod.emrwal.region.vpce.amazonaws.com`

1. Pour utiliser votre AWS PrivateLink point de terminaison, modifiez la `emr.wal.client.endpoint` configuration lorsque vous créez votre [cluster compatible Amazon EMR WAL](emr-hbase-wal-enabling.md), comme indiqué dans l'exemple suivant :

   ```
   [
       {
           "Classification": "hbase-site",
           "Properties": {
               "hbase.rootdir": "s3://amzn-s3-demo-bucket/MyHBaseStore",
               "emr.wal.workspace": "customWorkspaceName",
               "emr.wal.client.endpoint": "https://prod.emrwal.region.amazonaws.com"
           }
       },
       {
           "Classification": "hbase",
           "Properties": {
               "hbase.emr.storageMode": "s3",
               "hbase.emr.wal.enabled": "true"
           }
       }
   ]
   ```

Vous pouvez également utiliser la politique VPCE pour autoriser ou restreindre l'accès au WAL Amazon APIs EMR. Pour plus d’informations, consultez [Contrôle de l’accès aux points de terminaison d’un VPC à l’aide de politiques de point de terminaison](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) dans le *AWS PrivateLink *.

# Comprendre la tarification et les statistiques d'Amazon EMR WAL
<a name="emr-hbase-wal-metrics"></a>


| Unité de facturation des fonctionnalités de base | Détails | 
| --- | --- | 
| EMR-WAL-Read-GiB | API calls to read data from your table are billed as ReadRequestGiB. This includes [`Get` and `Scan`](https://hbase.apache.org/book.html#_data_model_operations) operations. Reads are charged based on the sizes of the read items. Amazon EMR bills at a minimum of 1 byte. For example, if you read a 1234.12 bytes item, you're charged for 1235 bytes. Reads are aggregated every hour for billing and shown as GiBs. | 
| EMR-WAL-Write-GiB | API calls to write data from your table are billed as Write-GiB. This includes [https://hbase.apache.org/book.html#_data_model_operations](https://hbase.apache.org/book.html#_data_model_operations) operations. Writes are charged based on the sizes of the written items. Amazon EMR bills at a minimum of 1 byte. For example, if you write a 1234.12 bytes item, you're charged for 1235 bytes. Writes are aggregated every hour for billing and shown as GiBs. | 
| EMR-WAL-WALHours | Le numéro WALs que vous enregistrez sur le service est facturé comme`EMR-WAL-WALHours`. Amazon EMR crée un WAL par région. HBase Par exemple, si vous créez 20 HBase tables, y compris des tables système, et que chaque table comporte deux HBase régions, vous utilisez 28 800 heures WAL, calculées comme suit : <pre>  20 tables <br />x  2 Regions per table <br />x  1 WAL per Region <br />x 30 days <br />x 24 hours <br />-----------<br />28,800 EMR-WAL-WALHours</pre> | 

**Exemple `EMRWALCount` :**

![\[Line graph showing ResourceCount fluctuations over time, ranging from about 18.87 to 19.20.\]](http://docs.aws.amazon.com/fr_fr/emr/latest/ReleaseGuide/images/wal-metric.png)


**Exemple `EMRWALWorkspaceCount` :**

![\[Graph showing ResourceCount fluctuations over time, ranging from 7.97 to 8.32.\]](http://docs.aws.amazon.com/fr_fr/emr/latest/ReleaseGuide/images/wal-metric2.png)


# Marquage des espaces de travail WAL
<a name="emr-hbase-wal-tagging"></a>

Vous pouvez ajouter des balises à un espace de travail lorsque vous créez un nouvel espace de travail et vous pouvez ajouter, supprimer ou répertorier des balises d'un espace de travail actif pour un cluster en cours d'exécution. Vous ne pouvez pas étiqueter les ressources individuelles de l'espace de travail, ni mettre à jour les balises existantes. Supprimez plutôt les balises indésirables de l'espace de travail et remplacez-les.

Vous pouvez baliser des espaces de travail à partir duEMRWAL CLI. Pour obtenir la liste des EMRWAL CLI commandes permettant de baliser les espaces de travail, consultez. [Référence de la EMRWAL CLI Amazon EMR WAL ()](emrwalcli-ref.md)

L'exemple de politique IAM suivant illustre un scénario qui autorise les opérations CRUDL de l'espace de travail uniquement avec la clé `resource_tag_allow_test_key` et la valeur de balisage appropriées : `resource_tag_allow_test_value`

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject",
        "s3:ListBucket"
      ],
      "Effect": "Allow",
      "Resource": [
        "*"
      ],
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/resource_tag_allow_test_key": [
            "resource_tag_allow_test_value"
          ]
        }
      },
      "Sid": "AllowEMRWAL"
    }
  ]
}
```

------

Pour vérifier que la balise est désormais requise pour les opérations de l'espace de travail, utilisez la [Référence de la EMRWAL CLI Amazon EMR WAL ()](emrwalcli-ref.md) [`listTagsForResource`](emrwalcli-ref.md#emrwalcli-ref-listtagsforresource)commande `tagAllowResourceTag` pour activer l'espace de travail avec la balise de ressource souhaitée. Si vous avez correctement configuré la condition, la commande aboutira.

```
emrwal listTagsForResource -r us-east-1 -arn arn:aws:emrwal:us-east-1:arn:workspace/tagAllowResourceTag
Tag(Key=resource_tag_allow_test_key, Value=resource_tag_allow_test_value)
```

# Réplication entre clusters EMR WAL
<a name="emr-hbase-wal-cross-cluster"></a>

À partir d'EMR 7.5, EMR WAL prend en charge la HBase réplication entre clusters des journaux à écriture anticipée. Cette rubrique explique comment activer cette fonctionnalité et vérifier qu'elle fonctionne. Pour plus de détails sur la réplication en cluster, consultez la section Réplication en [cluster dans la documentation](https://hbase.apache.org/book.html#_cluster_replication) Apache. HBase 

**Note**  
Des coûts de lecture supplémentaires sont associés aux journaux à écriture anticipée, car le processus de réplication lit les données depuis le WAL EMR local. Pour plus d'informations sur les coûts, consultez la section À [propos des versions d'Amazon EMR.](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-wal-metrics.html)

## Configuration de la réplication entre clusters
<a name="emr-hbase-wal-cross-cluster-setup"></a>

Afin d'offrir la même expérience utilisateur, l'activation de la fonctionnalité de réplication sur EMR WAL est la même que pour les journaux d' HBase écriture anticipée natifs. La procédure qui suit fournit un exemple simple. Pour plus d'informations, consultez la HBase documentation sur [Cluster Replication](https://hbase.apache.org/book.html#_cluster_replication).

1. Démarrez un cluster principal, qui est la source de réplication, avec EMR WAL activé. Pour activer les journaux à écriture anticipée, consultez. [Activation d'Amazon EMR WAL](emr-hbase-wal-enabling.md) Démarrez également un cluster homologue. Pour ce cluster de pairs, vous pouvez choisir d'activer ou non EMR WAL.

1. Sur les deux clusters, créez une table :

   ```
   HBASE_CMD="sudo -u hbase hbase"
   echo "create 'test_replication_table',{NAME => 'CF'}" | $HBASE_CMD shell
   ```

1. Ajoutez une configuration homologue sur le cluster principal et activez la réplication des tables. Lors de l'ajout du pair, il a besoin du nom d'hôte du nœud maître du cluster homologue, qui est **PEER\$1DNS**.

   ```
   HBASE_CMD="sudo -u hbase hbase"
   PEER_DNS="ip-10-1-1-0.ec2.com"
   PEER_NAME="aws"
   TABLE_NAME="test_replication_table"
   
   ## Create peering with the destination cluster
   echo "add_peer '$PEER_NAME', CLUSTER_KEY => '$PEER_DNS:2181:/hbase'" | $HBASE_CMD shell
   
   ## List peers in the primary cluster to confirm peer setup
   echo "list_peers" | $HBASE_CMD shell
   
   ## Enable table replication
   echo "enable_table_replication '$TABLE_NAME'" | $HBASE_CMD shell
   ```

## Confirmation de la réplication entre clusters
<a name="emr-hbase-wal-cross-cluster-confirm"></a>

Après avoir effectué les étapes de configuration, la réplication est activée entre le cluster principal et le cluster homologue. Un test s'ensuit pour confirmer le bon fonctionnement de la réplication.

1. Ajoutez des données sur le cluster principal et vérifiez les données répliquées sur le cluster homologue.

   ```
   ## Write on primary cluster with HBase CLI
   
   put 'test_replication_table', 'aaa', 'CF:a', 'aaa_a1'
   put 'test_replication_table', 'bbb', 'CF:b', 'bbb_b1'
   put 'test_replication_table', 'ccc', 'CF:c', 'ccc_c1'
   ```

1. Confirmez la réussite de la réplication sur le cluster homologue. Dans ce cas, vous devriez voir des données répliquées écrites du cluster principal vers le cluster homologue.

   ```
   ### Scan on peer cluster with HBase CLI
   
   scan 'test_replication_table'
   ```

# Considérations et régions relatives à Amazon EMR WAL
<a name="emr-hbase-wal-considerations"></a>

## Considérations relatives à Amazon EMR WAL
<a name="emr-hbase-wal-consid"></a>

La liste suivante décrit les principales considérations et limites d'Amazon EMR WAL :
+ Amazon EMR WAL peut être utilisé avec les versions 6.15.0 et supérieures d'Amazon EMR.
+ Amazon EMR WAL est un service payant optionnel. Vous payez pour ce que vous utilisez : lecture, écriture et stockage de données. Pour plus d'informations, consultez [Comprendre la tarification et les statistiques d'Amazon EMR WAL](emr-hbase-wal-metrics.md) la page de [tarification d'Amazon EMR.](https://aws.amazon.com/emr/pricing/)
+ Amazon EMR WAL utilise le HBase Write Ahead Log (WAL). Pour utiliser Amazon EMR WAL, vos clusters doivent utiliser HBase WAL.
+ Pour activer Amazon EMR WAL lorsque vous créez un cluster, vous devez disposer des autorisations de rôle requises. Pour plus d'informations, voir [Utilisation de rôles liés à un service pour la journalisation anticipée.](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html)
+ Vous devez activer Amazon EMR WAL lorsque vous créez le cluster avec l'API AWS Management Console, ou AWS CLI, et vous devez utiliser la configuration des *groupes d'instances*. Vous ne pouvez pas activer Amazon EMR WAL dans un cluster en cours d'exécution si vous n'avez pas créé le cluster avec Amazon EMR WAL. Vous ne pouvez pas non plus modifier les `hbase-site` configurations pour activer Amazon EMR WAL dans un cluster en cours d'exécution.
+ Vous ne pouvez activer Amazon EMR WAL que sur les clusters qui utilisent Amazon S3 comme répertoire racine.
+ Avant la version 7.5.0 d'Amazon EMR, les enregistrements dans Amazon EMR WAL devaient être de 4 Mo ou moins. Mais avec Amazon EMR version 7.5.0 et versions ultérieures, la taille d'enregistrement maximale dans EMR WAL est configurable à l'aide de la propriété. `emr.wal.max.payload.size` La valeur par défaut est de 1 Go. L'exemple suivant définit la taille d'enregistrement maximale à 2 Go :

  ```
  [
    {
      "Classification":"hbase-site",
      "Properties": {
         "emr.wal.max.payload.size": "2147483648"
      }
    }
  ]
  ```
+ Vous ne pouvez pas avoir plusieurs clusters actifs sur le même répertoire HBase racine dans Amazon S3.
+ Vous ne pouvez pas activer Amazon EMR WAL sur des clusters de répliques en lecture.
+ Le WAL est répliqué dans les zones de disponibilité du service géré.
+ Le WAL survit au cluster et reste disponible pour le cluster suivant.
+ Vous ne pouvez pas désactiver Amazon EMR WAL lors du lancement ou lorsque votre cluster est opérationnel (en cours d'exécution).
+ Pour plus d'informations sur les limites du WAL et de l'espace de travail, consultez la section [Points de terminaison et quotas Amazon EMR.](https://docs.aws.amazon.com/general/latest/gr/emr.html)

## Disponibilité régionale pour Amazon EMR WAL
<a name="emr-hbase-wal-regions"></a>

Le service Amazon EMR WAL est disponible dans les pays suivants : Régions AWS
+ `ap-northeast-1` – Asie-Pacifique (Tokyo)
+ `ap-northeast-2` – Asie-Pacifique (Séoul)
+ `ap-southeast-1` – Asie-Pacifique (Singapour)
+ `ap-south-1` – Asie-Pacifique (Mumbai)
+ `ap-southeast-2` – Asie-Pacifique (Sydney)
+ `eu-central-1` – Europe (Francfort)
+ `eu-north-1` – Europe (Stockholm)
+ `eu-west-1` – Europe (Irlande)
+ `sa-east-1` – Amérique du Sud (São Paulo)
+ `us-east-1` – USA Est (Virginie du Nord)
+ `us-east-2` – USA Est (Ohio)
+ `us-west-2` – USA Ouest (Oregon)

Les régions suivantes ne seront disponibles qu'avec Amazon EMR version 7.3.0 ou ultérieure :
+ `ap-east-1` – Asie-Pacifique (Hong Kong)
+ `af-south-1` – Afrique (Le Cap) 
+ `ca-central-1` – Canada (Centre)
+ `eu-west-2` – Europe (Londres)

# Référence de la EMRWAL CLI Amazon EMR WAL ()
<a name="emrwalcli-ref"></a>

L'*interface de ligne de EMRWAL commande (EMRWAL CLI)* est un outil unifié permettant de gérer votre journal d'écriture anticipée (WAL) pour Amazon EMR. Il est EMRWAL CLI livré avec des clusters EMR lorsque vous activez WAL au moment de créer un cluster. Pour plus d'informations sur l'activation de WAL, consultez[Journaux d'écriture anticipée (WAL) pour Amazon EMR](emr-hbase-wal.md).

EMRWAL CLICela inclut les commandes suivantes :

**Topics**
+ [`createWorkspace`](#emrwalcli-ref-createworkspace)
+ [`deleteWal`](#emrwalcli-ref-deletewal)
+ [`deleteWorkspace`](#emrwalcli-ref-deleteworkspace)
+ [`listTagsForResource`](#emrwalcli-ref-listtagsforresource)
+ [`listWals`](#emrwalcli-ref-listwals)
+ [`listWorkspaces`](#emrwalcli-ref-listworkspaces)
+ [`tagResource`](#emrwalcli-ref-tagresource)
+ [`untagResource`](#emrwalcli-ref-untagresource)

## `createWorkspace`
<a name="emrwalcli-ref-createworkspace"></a>

La `createWorkspace` commande crée un nouvel espace de travail Amazon EMR WAL.

**Utilisation :**

```
emrwal createWorkspace [-tags <tags>] [-e {endpoint}] [-r {Region}] -w {workspacename} [-h]
```

**Exemple :**

```
emrwal createWorkspace -w examplews
```

## `deleteWal`
<a name="emrwalcli-ref-deletewal"></a>

La `deleteWals` commande supprime le WAL Amazon EMR que vous spécifiez.

**Utilisation :**

```
emrwal deleteWal [-e {endpoint}] [-r {Region}] [-w {workspacename}] [-p <tablePrefix>] [-n <walName>] [-N <fullName>] [-R] [-m] [-h]
```

**Exemple :**

```
emrwal deleteWal -w examplews -p hbasetable -n examplewal
```

## `deleteWorkspace`
<a name="emrwalcli-ref-deleteworkspace"></a>

La `deleteWorkspace` commande supprime l'espace de travail Amazon EMR WAL que vous spécifiez.

**Utilisation :**

```
emrwal deleteWorkspace [-e {endpoint}] [-r {Region}] -w {workspacename} [-h]
```

**Exemple :**

```
emrwal deleteWorkspace -w examplews
```

## `listTagsForResource`
<a name="emrwalcli-ref-listtagsforresource"></a>

La `listTagsForResource` commande répertorie toutes les paires clé-valeur pour l'espace de travail Amazon EMR WAL que vous spécifiez.

**Utilisation :**

```
emrwal listTagsForResource -arn {resource-arn} [-e {endpoint}] [-r {Region}] [-h]
```

**Exemple :**

```
emrwal listTagsForResource -arn arn:aws:emrwal::1234567891234:workspace/examplews
```

## `listWals`
<a name="emrwalcli-ref-listwals"></a>

La `listWals` commande répertorie tous les Amazon EMR présents WALs dans l'espace de travail que vous spécifiez.

**Utilisation :**

```
emrwal listWals [-nextToken {token-string}] [-pageSize {integer}] [-e {endpoint}] [-r {Region}] [-w {workspacename}] [-p <tablePrefix>] [-M {integer}] [-h]
```

**Exemple :**

```
emrwal listWals -w examplews
```

## `listWorkspaces`
<a name="emrwalcli-ref-listworkspaces"></a>

La `listWorkspaces` commande répertorie tous les espaces de travail Amazon EMR WAL qui sont à votre disposition.

**Utilisation :**

```
emrwal listWorkspaces [-nextToken {token-string}] [-pageSize {integer}] [-e {endpoint}] [-r {Region}] [-M {integer}] [-h]
```

**Exemple :**

```
emrwal listWorkspaces
```

## `tagResource`
<a name="emrwalcli-ref-tagresource"></a>

La `tagResource` commande attribue une ou plusieurs paires clé-valeur à l'espace de travail Amazon EMR WAL que vous spécifiez.

**Utilisation :**

```
emrwal tagResource -arn {resource-arn} -tags <tags> [-e {endpoint}] [-r {Region}] [-h]
```

**Exemple :**

```
emrwal tagResource -arn arn:aws:emrwal::1234567891234:workspace/examplews -tags tag_key=tag_value
```

## `untagResource`
<a name="emrwalcli-ref-untagresource"></a>

La `untagResource` commande annule l'attribution d'une ou de plusieurs paires clé-valeur à l'espace de travail Amazon EMR WAL que vous spécifiez.

**Utilisation :**

```
emrwal untagResource -arn {resource-arn} -tagKeys <tagKeys> [-e {endpoint}] [-r {Region}] [-h]
```

**Exemple :**

```
emrwal untagResource -arn arn:aws:emrwal::1234567891234:workspace/examplews -tagKeys tag_key
```