

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Registri WAL (WRITE-AHEAD LOG) per Amazon EMR
<a name="emr-hbase-wal"></a>

Con Amazon EMR 6.15 e versioni successive, puoi scrivere i tuoi registri WAL ( HBase write-ahead log) di Apache nel WAL di Amazon EMR. Nelle versioni precedenti di Amazon EMR, quando crei un cluster con l'opzione **HBase su Amazon S3**, WAL è l'unico componente HBase Apache che viene archiviato nel disco locale per i cluster e puoi archiviare altri componenti come la directory principale, store files HFiles (), i metadati delle tabelle e i dati su Amazon S3.

Puoi usare Amazon EMR WAL per recuperare dati che non sono stati trasferiti su Amazon S3. Per eseguire il backup completo HBase dei cluster, scegli di utilizzare il servizio WAL di Amazon EMR. Dietro le quinte, `RegionServer` scrive i tuoi log di HBase scrittura in anticipo (WAL) nel WAL per Amazon EMR.

Nel caso in cui il cluster o l'AZ diventino non integri o non disponibili, puoi creare un nuovo cluster, indirizzarlo alla stessa directory principale S3 e allo stesso spazio di lavoro WAL di Amazon EMR e ripristinare automaticamente i dati in WAL in pochi minuti. Per ulteriori informazioni, consulta [Ripristino da Amazon EMR WAL](emr-hbase-wal-restoring.md).

A partire dalle versioni 7.3.0 e successive di Amazon EMR, Amazon EMR crea più EMR per ogni server e raggruppa più regioni HBase in un unico Amazon WALs EMR WAL. In questo modo potenzia Apache HBase WAL per migliorare l'utilizzo dei log e ottimizzare i costi. Per configurare il numero di istanze WAL di Amazon EMR per volta HBase `RegionServer`, utilizza il parametro. `hbase.wal.regiongrouping.numgroups` Per impostazione predefinita, questo parametro è impostato su 2. Esistono due tabelle di sistema che non sono incluse in nessun gruppo WAL: *meta* e *masterstore*. Queste tabelle utilizzano sempre le proprie impostazioni individuali. WALs 

Se esegui una versione precedente ad Amazon EMR 7.3.0, ti consigliamo di disabilitare manualmente le tabelle nel vecchio HBase cluster per assicurarti che tutti i dati nel WAL di Amazon EMR vengano trasferiti in Amazon S3. Quindi, elimina il vecchio WAL di Amazon EMR, termina il vecchio cluster e configura un nuovo cluster che esegue l'ultima versione. Se riscontri problemi e non riesci a disabilitare le tabelle sul vecchio cluster, puoi terminare direttamente il vecchio cluster e `emr.wal.multiplex.migrate` impostarlo su`true`. sul nuovo cluster. Se impostato su true, HBase tenterà di riprodurre i dati delle vecchie istanze WAL di Amazon EMR HBase durante l'inizializzazione della regione e di eliminare le vecchie istanze dopo la riproduzione. WALs Questo processo di riproduzione comporta costi aggiuntivi per le letture. Dopo la migrazione, si consiglia di configurare il cluster e impostarlo su. `emr.wal.multiplex.migrate` `false` In alternativa, è possibile rimuovere il parametro per accelerare l'inizializzazione HBase della regione.

**Nota**  
 Amazon EMR WAL elimina i dati dopo averli scaricati. HBase Se HBase non elimina i dati, Amazon EMR WAL li conserva per un massimo di 30 giorni. Dopo 30 giorni, Amazon EMR WAL elimina automaticamente i dati. Amazon EMR conserva le istanze WAL per un massimo di 30 giorni dalla chiusura di un cluster EMR. Tuttavia, se avvii un nuovo cluster abilitato a WAL dalla stessa directory principale S3 entro questi 30 giorni, Amazon EMR non eliminerà nessuna delle istanze WAL dal cluster precedente. Per ulteriori informazioni, consulta [Ripristino da Amazon EMR WAL](emr-hbase-wal-restoring.md).

Le seguenti sezioni descrivono come configurare e utilizzare Amazon EMR WAL con il tuo cluster EMR abilitato HBase.

**Topics**
+ [Spazi di lavoro WAL di Amazon EMR](emr-hbase-wal-workspaces.md)
+ [Autorizzazioni richieste per Amazon EMR WAL](emr-hbase-wal-permissions.md)
+ [Attivazione di Amazon EMR WAL](emr-hbase-wal-enabling.md)
+ [Ripristino da Amazon EMR WAL](emr-hbase-wal-restoring.md)
+ [Utilizzo di configurazioni di sicurezza con Amazon EMR WAL](emr-hbase-wal-security.md)
+ [Accedi ad Amazon EMR WAL tramite AWS PrivateLink](emr-hbase-wal-privatelink.md)
+ [Comprendere i prezzi e i parametri WAL di Amazon EMR](emr-hbase-wal-metrics.md)
+ [Etichettatura degli spazi di lavoro WAL](emr-hbase-wal-tagging.md)
+ [Replica tra cluster EMR WAL](emr-hbase-wal-cross-cluster.md)
+ [Considerazioni e regioni per Amazon EMR WAL](emr-hbase-wal-considerations.md)
+ [Riferimento alla CLI di Amazon EMR WAL () EMRWAL](emrwalcli-ref.md)

# Spazi di lavoro WAL di Amazon EMR
<a name="emr-hbase-wal-workspaces"></a>

Amazon EMR WAL aggiunge il concetto di spazi di lavoro WAL. Uno *spazio di lavoro WAL* è un contenitore logico di. WALs Ogni log write-ahead in Amazon EMR WAL è incapsulato da un'area di lavoro WAL. Un cluster EMR scrive esattamente WALs su uno spazio di lavoro WAL configurato all'avvio del cluster o su `defaultWALworkspace` se non si specifica uno spazio di lavoro. Gli spazi di lavoro WAL non sono correlati ad alcuna terminologia esistente come i namespace. HBase 

Puoi utilizzare le aree di lavoro WAL per definire le autorizzazioni WAL IAM di Amazon EMR in modo da includere solo le aree di lavoro a cui il cluster deve accedere. Puoi anche etichettare il tuo spazio di lavoro WAL per il controllo degli accessi basato su tag. Per ulteriori informazioni sull'etichettatura, vedere. [Etichettatura degli spazi di lavoro WAL](emr-hbase-wal-tagging.md)

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


# Autorizzazioni richieste per Amazon EMR WAL
<a name="emr-hbase-wal-permissions"></a>

Affinché il cluster possa connettersi ad Amazon EMR WAL, il profilo dell'istanza del cluster richiede determinate autorizzazioni IAM:
+ Amazon EMR WAL utilizza il ruolo [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)collegato al servizio per recuperare lo stato di un cluster. Amazon EMR crea automaticamente questo ruolo collegato al servizio quando crei uno spazio di lavoro WAL o HBase creerà il ruolo collegato al servizio quando configuri uno spazio di lavoro per Amazon EMR WAL e il ruolo collegato al servizio non esiste ancora.

  Prima di poter abilitare Amazon EMR WAL per un cluster, devi configurare le autorizzazioni per consentire la creazione automatica del ruolo collegato al servizio. AWSServiceRoleForEMRWAL Per ulteriori informazioni e un'istruzione di esempio che aggiunge questa funzionalità, consulta [Using service-linked](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html#using-service-linked-roles-permissions-wal) roles for write-ahead logging.
+ Poiché Amazon EMR WAL utilizza HBase Write Ahead Log (WAL), i tuoi cluster devono utilizzare WAL. HBase Di seguito sono riportate le autorizzazioni IAM minime necessarie per l'esecuzione. HBase Aggiungili alla politica di autorizzazione per il tuo profilo di istanza:

  ```
  emrwal:DeleteWal
  emrwal:CreateWal
  emrwal:CreateWorkspace
  emrwal:AppendEdit
  emrwal:ReplayEdits
  emrwal:GetCurrentWalTime
  emrwal:CompleteWalFlush
  emrwal:ListWALs
  emrwal:DescribeWAL
  emrwal:TrimWAL
  emrwal:ArchiveWAL
  emrwal:ArchiveWALCheckPoint
  ```
**Nota**  
Se limiti le autorizzazioni per Amazon EMR WAL solo al set minimo, alcuni comandi [EMRWALCLI](emrwalcli-ref.md) non disporranno delle autorizzazioni necessarie per l'esecuzione.

# Attivazione di Amazon EMR WAL
<a name="emr-hbase-wal-enabling"></a>

Utilizza i seguenti passaggi per abilitare la scrittura su Amazon EMR WAL quando crei un cluster con. AWS Command Line Interface

**Nota**  
Non puoi abilitare Amazon EMR WAL per un cluster già in esecuzione e non puoi avviare due cluster con la stessa directory principale S3. Per ulteriori informazioni, consulta [Considerazioni e regioni per Amazon EMR WAL](emr-hbase-wal-considerations.md).

1. Prima di poter creare un cluster abilitato per Amazon EMR WAL, devi aggiungere le autorizzazioni richieste al profilo dell'istanza che intendi utilizzare con il tuo cluster. Per ulteriori informazioni, consulta [Autorizzazioni richieste per Amazon EMR WAL](emr-hbase-wal-permissions.md).

1. Crea un cluster da. AWS CLI Utilizzate l'`--configurations`opzione per fornire un oggetto di configurazione JSON che specifichi la `hbase.emr.wal.enabled` proprietà, come illustrato nell'esempio seguente.
   + Specificare la modalità di storage e la posizione della directory principale in Amazon S3. La posizione Amazon S3 specificata deve trovarsi nella stessa regione del cluster EMR, ma solo un cluster attivo può utilizzare la stessa directory HBase principale in S3 alla volta.
   + Crea il tuo cluster con la configurazione dei gruppi di istanze. Non puoi utilizzare Amazon EMR WAL con la configurazione delle flotte di istanze. Per ulteriori informazioni sulla creazione di cluster con gruppi di istanze, consulta [Configura gruppi di istanze uniformi](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-uniform-instance-group.html) nella *Amazon EMR Management Guide.*
   + Per i passaggi da console per creare un cluster e un `create-cluster` esempio dettagliato che utilizza il AWS CLI, consulta [Creazione di un cluster con](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-create.html). HBase

1. Per abilitare WAL per il nuovo cluster, imposta la `hbase.emr.wal.enabled` proprietà su. `true` Il comando seguente contiene un frammento di codice JSON con un oggetto di configurazione di esempio.

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

Quando HBase è online sul cluster appena creato, HBase scriverà automaticamente i dati WAL su Amazon EMR WAL e utilizzerà il WAL di Amazon EMR per scopi di ripristino. 

**Example 1: Creazione di un cluster EMR che utilizza 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: Creazione di un cluster EMR con uno spazio di lavoro WAL personalizzato**  

```
[
    {
        "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"
        }
    }
]
```

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

Poiché il WAL di Amazon EMR per il tuo cluster originale viene conservato per 30 giorni, puoi ripristinare e riutilizzare il WAL per un cluster appena creato entro quel periodo di 30 giorni. Quando avvii un nuovo cluster dalla stessa directory principale di S3, Amazon EMR mantiene le istanze WAL del tuo vecchio cluster. Se interrompi questo nuovo cluster, l'orologio di 30 giorni riparte dal momento in cui lo interrompi.

Utilizzare la procedura seguente per ripristinare un WAL esistente con un nuovo cluster. Questo processo presuppone che tu abbia creato il cluster originale con Amazon EMR WAL abilitato.

1. Entro 30 giorni dalla creazione di un cluster abilitato per WAL, crea un nuovo cluster nello stesso Regione AWS del cluster originale. Il nuovo cluster può trovarsi nella stessa AZ o in una AZ diversa all'interno della stessa regione in cui è stato creato il cluster originale.

   Configura le proprietà dell'oggetto per specificare la modalità di storage e la posizione della directory principale in Amazon S3. La posizione Amazon S3 specificata deve trovarsi nella stessa regione del cluster EMR, ma solo un cluster attivo può utilizzare la stessa directory HBase principale in S3 alla volta.

   Per i passaggi da console per creare un cluster e un `create-cluster` esempio dettagliato che utilizza il AWS CLI, consulta [Creazione di un](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-create.html) cluster con. HBase

1. Per utilizzare il WAL esistente di Amazon EMR per il nuovo cluster, imposta la `hbase.emr.wal.enabled` proprietà su. `true` Il seguente frammento di codice JSON mostra un esempio di oggetto di configurazione.

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

# Utilizzo di configurazioni di sicurezza con Amazon EMR WAL
<a name="emr-hbase-wal-security"></a>

Amazon EMR crittografa automaticamente sia i dati in transito tra il cluster e il servizio Amazon EMR WAL, sia i dati inattivi in Amazon EMR WAL. Per ulteriori informazioni, consulta [Encryption at rest for Amazon EMR WAL](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-data-encryption-options.html#emr-encryption-WAL). Puoi anche utilizzare una configurazione di sicurezza per importare le tue chiavi dal servizio AWS Key Management Service (KMS) e crittografare i dati archiviati in Amazon EMR WAL. 

Utilizza uno dei seguenti metodi per selezionare una configurazione di sicurezza quando crei un cluster:

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

Da Console di gestione AWS, specifica la configurazione in Configurazione **di sicurezza e coppia di chiavi EC2**.

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


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

Da AWS CLI, imposta il `--security-configuration` parametro quando usi il comando [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html).

------

Per ulteriori informazioni, consulta [Encryption at rest for Amazon EMR WAL](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-data-encryption-options.html#emr-encryption-WAL) e [Use security configurations to setup cluster security nella](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-security-configurations.html) Amazon *EMR* Management Guide.

[Per ulteriori informazioni relative alla sicurezza su WAL, consulta Using service-linked roles for write-ahead logging.](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html)

# Accedi ad Amazon EMR WAL tramite AWS PrivateLink
<a name="emr-hbase-wal-privatelink"></a>

Se desideri mantenere la connessione all'interno della AWS rete, Amazon EMR WAL offre supporto. AWS PrivateLink Per la configurazione AWS PrivateLink, usa Console di gestione AWS or AWS Command Line Interface (AWS CLI) per creare un endpoint VPC di interfaccia che si connette a Amazon EMR WAL. *Per ulteriori informazioni, consulta [Accedere a un AWS servizio utilizzando un endpoint VPC di interfaccia nella Guida](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html).AWS PrivateLink *

I passaggi di base sono i seguenti:

1. Usa la console Amazon VPC per [creare un endpoint VPC.](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) **Seleziona **Endpoints, quindi Crea endpoint**.**

1. **Mantieni la categoria Servizi come AWS servizi.**

1. Nella barra di ricerca del pannello **Servizi****emrwal**, digita e seleziona il servizio etichettato`com.amazonaws.region.emrwal.prod`.

1. Seleziona il tuo VPC e salva l'endpoint. Assicurati di collegare all'endpoint VPC gli stessi gruppi di sicurezza che colleghi al cluster EMR.

1. Se lo desideri, ora puoi abilitare i nomi host DNS privati per il tuo nuovo endpoint. Imposta **Enable DNS hostnames** e **Enable DNS Support** su `true` per il tuo VPC. Quindi, seleziona il tuo ID endpoint, scegli **Modifica impostazioni VPC** dal menu Azioni e abilita **i** nomi DNS privati.
   + I nomi host DNS privati per l'endpoint seguiranno il formato. `prod.emrwal.region.amazonaws.com`
   + Se non abiliti i nomi host DNS privati, Amazon VPC ti fornisce un nome di endpoint DNS nel formato indicato. `endpointID.prod.emrwal.region.vpce.amazonaws.com`

1. Per utilizzare il tuo AWS PrivateLink endpoint, modifica la `emr.wal.client.endpoint` configurazione quando crei il cluster [abilitato per Amazon EMR WAL](emr-hbase-wal-enabling.md), come mostrato nell'esempio seguente:

   ```
   [
       {
           "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"
           }
       }
   ]
   ```

Puoi anche utilizzare la policy VPCE per consentire o limitare l'accesso al WAL di Amazon EMR. APIs Per ulteriori informazioni, consulta [Control access to VPC endpoints using endpoint policies](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) nella *Guida di AWS PrivateLink *.

# Comprendere i prezzi e i parametri WAL di Amazon EMR
<a name="emr-hbase-wal-metrics"></a>


| Unità di fatturazione delle funzionalità principali | Informazioni | 
| --- | --- | 
| 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 | Viene fatturato il numero di WALs quello che memorizzi sul servizio. `EMR-WAL-WALHours` Amazon EMR crea un WAL per regione. HBase Ad esempio, se crei 20 HBase tabelle, incluse le tabelle di sistema, e ogni tabella ha due HBase regioni, utilizzi 28.800 ore WAL, calcolate come: <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> | 

**`EMRWALCount`Esempio:**

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


**Esempio`EMRWALWorkspaceCount`:**

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


# Etichettatura degli spazi di lavoro WAL
<a name="emr-hbase-wal-tagging"></a>

Puoi aggiungere tag a uno spazio di lavoro quando crei un nuovo spazio di lavoro e puoi aggiungere, rimuovere o elencare i tag da uno spazio di lavoro attivo per un cluster in esecuzione. Non puoi etichettare le singole risorse nell'area di lavoro e non puoi aggiornare i tag esistenti; rimuovi invece i tag indesiderati dall'area di lavoro e sostituiscili.

Puoi taggare le aree di lavoro da. EMRWAL CLI Per un elenco di EMRWAL CLI comandi per etichettare le aree di lavoro, consulta. [Riferimento alla CLI di Amazon EMR WAL () EMRWAL](emrwalcli-ref.md)

L'esempio seguente di politica IAM illustra uno scenario che consente le operazioni CRUDL dello spazio di lavoro solo con la chiave e il valore di tagging appropriati: `resource_tag_allow_test_key` `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"
    }
  ]
}
```

------

Per verificare che il tag sia ora necessario per le operazioni del workspace, usa il [`listTagsForResource`](emrwalcli-ref.md#emrwalcli-ref-listtagsforresource)comando [Riferimento alla CLI di Amazon EMR WAL () EMRWAL](emrwalcli-ref.md) to call on `tagAllowResourceTag` per l'area di lavoro con il tag di risorsa desiderato. Se la condizione è stata configurata correttamente, il comando avrà esito positivo.

```
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)
```

# Replica tra cluster EMR WAL
<a name="emr-hbase-wal-cross-cluster"></a>

A partire da EMR 7.5, EMR WAL supporta la replica HBase tra cluster di log write-ahead. Questo argomento mostra come abilitare la funzionalità e verificarne il funzionamento. Per maggiori dettagli sulla replica in cluster, consulta [Cluster Replication](https://hbase.apache.org/book.html#_cluster_replication) nella documentazione di Apache. HBase 

**Nota**  
I log write-ahead comportano costi di lettura aggiuntivi, poiché il processo di replica legge i dati dal WAL EMR locale. Per ulteriori dettagli sui costi, consulta [About Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-hbase-wal-metrics.html) Releases.

## Configurazione della replica tra cluster
<a name="emr-hbase-wal-cross-cluster-setup"></a>

Per avere la stessa esperienza utente, l'abilitazione della funzionalità di replica su EMR WAL è la stessa dei log write-ahead nativi. HBase La procedura che segue mostra un semplice esempio. Per ulteriori informazioni, vedere la HBase documentazione in [Cluster Replication.](https://hbase.apache.org/book.html#_cluster_replication)

1. Avvia un cluster primario, che è l'origine della replica, con EMR WAL abilitato. Per abilitare i log write-ahead, vedere. [Attivazione di Amazon EMR WAL](emr-hbase-wal-enabling.md) Inoltre, avvia un cluster di peer. Per questo cluster peer, puoi scegliere di abilitare EMR WAL o meno.

1. In entrambi i cluster, crea una tabella:

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

1. Aggiungi la configurazione peer sul cluster primario e abilita la replica delle tabelle. **Durante l'aggiunta peer, è necessario il nome host del nodo master del cluster peer, che è 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
   ```

## Conferma della replica tra cluster
<a name="emr-hbase-wal-cross-cluster-confirm"></a>

Dopo aver eseguito i passaggi di configurazione, la replica viene abilitata tra il cluster primario e il cluster peer. Segue un test che conferma il funzionamento della replica.

1. Aggiungi dati sul cluster primario e verifica i dati replicati nel cluster peer.

   ```
   ## 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. Conferma la corretta replica sul cluster peer. In questo caso, dovresti vedere i dati replicati scritti dal cluster primario al cluster peer.

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

# Considerazioni e regioni per Amazon EMR WAL
<a name="emr-hbase-wal-considerations"></a>

## Considerazioni per Amazon EMR WAL
<a name="emr-hbase-wal-consid"></a>

L'elenco seguente descrive importanti considerazioni e limitazioni di Amazon EMR WAL:
+ Amazon EMR WAL è disponibile per l'uso con le versioni 6.15.0 e successive di Amazon EMR.
+ Amazon EMR WAL è un servizio opzionale a pagamento. Paghi in base a ciò che usi: lettura, scrittura e archiviazione dei dati. Per ulteriori informazioni, consulta [Comprendere i prezzi e i parametri WAL di Amazon EMR](emr-hbase-wal-metrics.md) la pagina dei [prezzi di Amazon EMR.](https://aws.amazon.com/emr/pricing/)
+ Amazon EMR WAL utilizza HBase Write Ahead Log (WAL). Per utilizzare Amazon EMR WAL, i tuoi cluster devono utilizzare WAL. HBase 
+ Per abilitare Amazon EMR WAL quando crei un cluster, devi disporre delle autorizzazioni di ruolo richieste. Per ulteriori informazioni, consulta [Using service-linked roles for write-ahead logging](https://docs.aws.amazon.com/emr/latest/ManagementGuide/using-service-linked-roles-wal.html).
+ È necessario abilitare Amazon EMR WAL quando si crea il cluster con Console di gestione AWS AWS CLI, o API e utilizzare la configurazione dei gruppi di *istanze*. Non puoi abilitare Amazon EMR WAL in un cluster in esecuzione se non lo hai creato con Amazon EMR WAL. Inoltre, non puoi modificare le `hbase-site` configurazioni per abilitare Amazon EMR WAL in un cluster in esecuzione.
+ Puoi abilitare Amazon EMR WAL solo su cluster che utilizzano Amazon S3 per la directory principale.
+ Prima della versione 7.5.0 di Amazon EMR, i record in Amazon EMR WAL dovevano essere pari o inferiori a 4 MB. Ma con Amazon EMR versione 7.5.0 e successive, la dimensione massima dei record in EMR WAL è configurabile utilizzando la proprietà. `emr.wal.max.payload.size` Il valore predefinito è 1 GB. L'esempio seguente imposta la dimensione massima del record a 2 GB:

  ```
  [
    {
      "Classification":"hbase-site",
      "Properties": {
         "emr.wal.max.payload.size": "2147483648"
      }
    }
  ]
  ```
+ Non puoi avere più cluster attivi nella stessa directory HBase principale in Amazon S3.
+ Non puoi abilitare Amazon EMR WAL su cluster di replica di lettura.
+ Il WAL viene replicato tra le zone di disponibilità all'interno del servizio gestito.
+ WAL dura più a lungo del cluster e rimane disponibile per il cluster successivo.
+ Non puoi disabilitare Amazon EMR WAL durante l'avvio o quando il cluster è operativo (in stato di esecuzione).
+ Per informazioni sui limiti WAL e dello spazio di lavoro, consulta gli endpoint e le quote di Amazon [EMR.](https://docs.aws.amazon.com/general/latest/gr/emr.html)

## Disponibilità regionale per Amazon EMR WAL
<a name="emr-hbase-wal-regions"></a>

Il servizio WAL di Amazon EMR è disponibile nei seguenti paesi: Regioni AWS
+ `ap-northeast-1`: Asia Pacifico (Tokyo)
+ `ap-northeast-2`: Asia Pacifico (Seoul)
+ `ap-southeast-1`: Asia Pacifico (Singapore)
+ `ap-south-1`: Asia Pacifico (Mumbai)
+ `ap-southeast-2`: Asia Pacifico (Sydney)
+ `eu-central-1`: Europa (Francoforte)
+ `eu-north-1`: Europa (Stoccolma)
+ `eu-west-1`: Europa (Irlanda)
+ `sa-east-1`: Sud America (San Paolo)
+ `us-east-1`: Stati Uniti orientali (Virginia settentrionale)
+ `us-east-2`: Stati Uniti orientali (Ohio)
+ `us-west-2`: Stati Uniti occidentali (Oregon)

Le seguenti regioni sarebbero disponibili solo con Amazon EMR versione 7.3.0 o successiva:
+ `ap-east-1`: Asia Pacifico (Hong Kong)
+ `af-south-1`: Africa (Città del Capo) 
+ `ca-central-1`: Canada (Centrale)
+ `eu-west-2`: Europa (Londra)

# Riferimento alla CLI di Amazon EMR WAL () EMRWAL
<a name="emrwalcli-ref"></a>

La *EMRWALCommand Line Interface (EMRWAL CLI)* è uno strumento unificato per gestire il tuo write-ahead log (WAL) per Amazon EMR. Viene EMRWAL CLI fornito con i cluster EMR quando si abilita WAL al momento della creazione di un cluster. Per ulteriori informazioni sull'attivazione di WAL, vedere. [Registri WAL (WRITE-AHEAD LOG) per Amazon EMR](emr-hbase-wal.md)

EMRWAL CLIInclude i seguenti comandi:

**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>

Il `createWorkspace` comando crea un nuovo spazio di lavoro WAL di Amazon EMR.

**Utilizzo:**

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

**Esempio**:

```
emrwal createWorkspace -w examplews
```

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

Il `deleteWals` comando elimina il WAL di Amazon EMR specificato.

**Utilizzo:**

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

**Esempio**:

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

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

Il `deleteWorkspace` comando elimina l'area di lavoro WAL di Amazon EMR specificata.

**Utilizzo:**

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

**Esempio**:

```
emrwal deleteWorkspace -w examplews
```

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

Il `listTagsForResource` comando elenca tutti i tag di coppia chiave-valore per l'area di lavoro WAL di Amazon EMR specificata.

**Utilizzo:**

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

**Esempio**:

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

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

Il `listWals` comando elenca tutti gli Amazon EMR WALs nell'area di lavoro specificata.

**Utilizzo:**

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

**Esempio**:

```
emrwal listWals -w examplews
```

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

Il `listWorkspaces` comando elenca tutte le aree di lavoro WAL di Amazon EMR disponibili.

**Utilizzo:**

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

**Esempio**:

```
emrwal listWorkspaces
```

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

Il `tagResource` comando assegna uno o più tag di coppia chiave-valore all'area di lavoro WAL di Amazon EMR specificata.

**Utilizzo:**

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

**Esempio**:

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

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

Il `untagResource` comando annulla l'assegnazione di uno o più tag di coppia chiave-valore all'area di lavoro WAL di Amazon EMR specificata.

**Utilizzo:**

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

**Esempio**:

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