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à.

# Nozioni di base sulle trasformazioni visive personalizzate
<a name="custom-visual-transform-getting-started"></a>

 Per creare una trasformazione visiva personalizzata, completa la seguente procedura. 
+  Passaggio 1. Creazione di un file di configurazione JSON 
+  Passaggio 2. Implementazione della logica di trasformazione 
+  Fase 3. Convalida della trasformazione visiva personalizzata 
+  Passaggio 4. Aggiornamento della trasformazione visiva personalizzata in base alle necessità 
+  Fase 5. Utilizzo della trasformazione visiva personalizzata in AWS Glue Studio 

 Inizia configurando il bucket Amazon S3 e continua con la **Fase 1. Crea un file di configurazione JSON.** 

## Prerequisiti
<a name="custom-visual-transform-prerequisites"></a>

 Le trasformazioni fornite dal cliente risiedono all'interno di un account cliente. AWS Quell'account possiede le trasformazioni e quindi dispone di tutte le autorizzazioni per visualizzarle (ricerca e uso), modificarle o eliminarle. 

 Per utilizzare una trasformazione personalizzata inAWS Glue Studio, dovrai creare e caricare due file nel bucket di asset Amazon S3 di quell'account: AWS 
+  **File Python**: contiene la funzione di trasformazione. 
+  **File JSON**: descrive la trasformazione. Questo è noto anche come file di configurazione necessario per definire la trasformazione. 

 Per accoppiare i file, utilizzate lo stesso nome per entrambi. Esempio: 
+  myTransform.json 
+  myTransform.py 

 Facoltativamente, puoi assegnare alla tua trasformazione visiva personalizzata un'icona personalizzata fornendo un **file SVG** contenente l'icona. Per accoppiare i file, utilizza lo stesso nome per l'icona: 
+  myTransform.svg 

 AWS Glue Studio li abbinerà automaticamente utilizzando i rispettivi nomi dei file. I nomi dei file non possono essere uguali per nessun modulo esistente. 

## Convenzione consigliata per il nome del file della trasformazione
<a name="custom-visual-transform-recommended-transform-file-name"></a>

 AWS Glue Studio importerà il file come modulo (ad esempio, `import myTransform`) nello script del processo. Pertanto, il nome del file deve seguire le stesse regole di denominazione impostate per i nomi delle variabili python (identificatori). Nello specifico, devono iniziare con una lettera o un carattere di sottolineatura e poi essere composti interamente da lettere, cifre e trattini bassi. and/or 

**Nota**  
 Assicurati che il nome del file di trasformazione non sia in conflitto con i moduli python caricati esistenti (ad esempio, `sys, array, copy` ecc.) per evitare problemi di runtime imprevisti. 

## Configurazione del bucket Amazon S3
<a name="custom-visual-transform-setting-up-s3"></a>

 Le trasformazioni che crei vengono archiviate in Amazon S3 e sono di proprietà del tuo account. AWS È possibile creare nuove trasformazioni visive personalizzate semplicemente caricando i file (.json e .py) nella cartella delle risorse di Amazon S3 dove sono correntemente archiviati tutti gli script del processo (ad esempio, `s3://aws-glue-assets-<accountid>-<region>/transforms`). Se utilizzi un'icona personalizzata, carica anch'essa. Per impostazione predefinita, AWS Glue Studio leggerà tutti i file .json dalla cartella /transforms nello stesso bucket S3.