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à. # Fase 3: Formattazione dell'output dell'analisi delle entità come metadati Amazon Kendra Per convertire le entità estratte da Amazon Comprehend nel formato di metadati richiesto da un indice Amazon Kendra, esegui uno script Python 3. I risultati della conversione vengono archiviati nella `metadata` cartella del bucket Amazon S3. [Per ulteriori informazioni sul formato e sulla struttura dei metadati di Amazon Kendra, consulta Metadati dei documenti S3.](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) **Topics** + [Scaricamento ed estrazione dell'output di Amazon Comprehend](#tutorial-search-metadata-format-output-download-extract) + [Caricamento dell'output nel bucket S3](#tutorial-search-metadata-format-output-upload) + [Conversione dell'output in formato di metadati Amazon Kendra](#tutorial-search-metadata-format-output-script) + [Pulizia del bucket Amazon S3](#tutorial-search-metadata-format-output-cleanup) ## Scaricamento ed estrazione dell'output di Amazon Comprehend Per formattare l'output dell'analisi delle entità Amazon Comprehend, devi prima scaricare l'archivio di analisi delle entità Amazon Comprehend ed estrarre il file di `output.tar.gz` analisi delle entità. ### Per scaricare ed estrarre il file di output (Console) 1. Nel riquadro di navigazione della console Amazon Comprehend, accedi ai job di **analisi**. 1. Scegli il tuo lavoro `data-entities-analysis` di analisi delle entità. 1. In **Output**, scegli il link visualizzato accanto a **Posizione dei dati di output**. Questo ti reindirizza all'`output.tar.gz`archivio nel tuo bucket S3. 1. **Nella scheda **Panoramica, scegli Scarica**.** **Suggerimento** L'output di tutti i processi di analisi di Amazon Comprehend ha lo stesso nome. Rinominare l'archivio ti aiuterà a tracciarlo più facilmente. 1. Decomprimi ed estrai il file Amazon Comprehend scaricato sul tuo dispositivo. ### Per scaricare ed estrarre il file di output ()AWS CLI 1. Per accedere al nome della cartella generata automaticamente da Amazon Comprehend nel tuo bucket S3 che contiene i risultati del processo di analisi delle entità, usa il comando: [describe-entities-detection-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/comprehend/describe-entities-detection-job.html) ------ #### [ Linux ] ``` aws comprehend describe-entities-detection-job \ --job-id entities-job-id \ --region aws-region ``` Dove: + *entities-job-id*è stato salvato da, `comprehend-job-id` [Fase 2: Esecuzione di un processo di analisi delle entità su Amazon Comprehend](tutorial-search-metadata-entities-analysis.md) + *aws-region*è la tua AWS regione. ------ #### [ macOS ] ``` aws comprehend describe-entities-detection-job \ --job-id entities-job-id \ --region aws-region ``` Dove: + *entities-job-id*è stato salvato `comprehend-job-id` da[Fase 2: Esecuzione di un processo di analisi delle entità su Amazon Comprehend](tutorial-search-metadata-entities-analysis.md), + *aws-region*è la tua AWS regione. ------ #### [ Windows ] ``` aws comprehend describe-entities-detection-job ^ --job-id entities-job-id ^ --region aws-region ``` Dove: + *entities-job-id*è stato salvato `comprehend-job-id` da[Fase 2: Esecuzione di un processo di analisi delle entità su Amazon Comprehend](tutorial-search-metadata-entities-analysis.md), + *aws-region*è la tua AWS regione. ------ 1. Dall'`OutputDataConfig`oggetto nella descrizione del lavoro della tua entità, copia e salva il `S3Uri` valore come `comprehend-S3uri` in un editor di testo. **Nota** Il `S3Uri` valore ha un formato simile a*s3://amzn-s3-demo-bucket/.../output/output.tar.gz*. 1. Per scaricare l'archivio di output delle entità, usate il comando [copy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html): ------ #### [ Linux ] ``` aws s3 cp s3://amzn-s3-demo-bucket/.../output/output.tar.gz path/output.tar.gz ``` Dove: + *s3://amzn-s3-demo-bucket/.../output/output.tar.gz*è il `S3Uri` valore che hai salvato come`comprehend-S3uri`, + *path/*è la directory locale in cui si desidera salvare l'output. ------ #### [ macOS ] ``` aws s3 cp s3://amzn-s3-demo-bucket/.../output/output.tar.gz path/output.tar.gz ``` Dove: + *s3://amzn-s3-demo-bucket/.../output/output.tar.gz*è il `S3Uri` valore salvato come`comprehend-S3uri`, + *path/*è la directory locale in cui si desidera salvare l'output. ------ #### [ Windows ] ``` aws s3 cp s3://amzn-s3-demo-bucket/.../output/output.tar.gz path/output.tar.gz ``` Dove: + *s3://amzn-s3-demo-bucket/.../output/output.tar.gz*è il `S3Uri` valore salvato come`comprehend-S3uri`, + *path/*è la directory locale in cui si desidera salvare l'output. ------ 1. Per estrarre l'output delle entità, esegui il seguente comando in una finestra di terminale: ------ #### [ Linux ] ``` tar -xf path/output.tar.gz -C path/ ``` Dove: + *path/*è il percorso del file dell'`output.tar.gz`archivio scaricato sul dispositivo locale. ------ #### [ macOS ] ``` tar -xf path/output.tar.gz -C path/ ``` Dove: + *path/*è il percorso del file dell'`output.tar.gz`archivio scaricato sul dispositivo locale. ------ #### [ Windows ] ``` tar -xf path/output.tar.gz -C path/ ``` Dove: + *path/*è il percorso del file dell'`output.tar.gz`archivio scaricato sul dispositivo locale. ------ Al termine di questo passaggio, dovresti avere un file sul tuo dispositivo chiamato `output` con un elenco di entità identificate da Amazon Comprehend. ## Caricamento dell'output nel bucket S3 Dopo aver scaricato ed estratto il file di analisi delle entità Amazon Comprehend, carichi il file `output` estratto nel tuo bucket Amazon S3. ### Per caricare il file di output estratto da Amazon Comprehend (Console) 1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. **In **Bucket**, fai clic sul nome del tuo bucket, quindi scegli Carica.** 1. In **File e cartelle**, scegli **Aggiungi** file. 1. Nella finestra di dialogo, accedi al `output` file estratto sul dispositivo, selezionalo e scegli **Apri**. 1. **Mantieni le impostazioni predefinite per **Destinazione**, **Autorizzazioni** e Proprietà.** 1. Scegli **Carica**. ### Per caricare il file di output estratto da Amazon Comprehend ()AWS CLI 1. [Per caricare il `output` file estratto nel tuo bucket, usa il comando copy:](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html) ------ #### [ Linux ] ``` aws s3 cp path/output s3://amzn-s3-demo-bucket/output ``` Dove: + *path/*è il percorso locale del file estratto, `output` + amzn-s3-demo-bucket è il nome del bucket S3. ------ #### [ macOS ] ``` aws s3 cp path/output s3://amzn-s3-demo-bucket/output ``` Dove: + *path/*è il percorso locale del file estratto`output`, + amzn-s3-demo-bucket è il nome del bucket S3. ------ #### [ Windows ] ``` aws s3 cp path/output s3://amzn-s3-demo-bucket/output ``` Dove: + *path/*è il percorso locale del file estratto`output`, + amzn-s3-demo-bucket è il nome del bucket S3. ------ 1. [Per assicurarti che il `output` file sia stato caricato correttamente nel tuo bucket S3, controllane il contenuto usando il comando list:](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html) ------ #### [ Linux ] ``` aws s3 ls s3://amzn-s3-demo-bucket/ ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ #### [ macOS ] ``` aws s3 ls s3://amzn-s3-demo-bucket/ ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ #### [ Windows ] ``` aws s3 ls s3://amzn-s3-demo-bucket/ ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ ## Conversione dell'output in formato di metadati Amazon Kendra Per convertire l'output di Amazon Comprehend in metadati Amazon Kendra, esegui uno script Python 3. Se utilizzi la console, usala per questo passaggio. AWS CloudShell ### Per eseguire lo script Python 3 (Console) 1. Scarica il file [compresso converter.py.zip](https://docs.aws.amazon.com/kendra/latest/dg/samples/converter.py.zip) sul tuo dispositivo. 1. Estrarre il file Python 3. `converter.py` 1. Accedi alla [console di AWS gestione](https://aws.amazon.com/console/) e assicurati che la tua AWS regione sia impostata sulla stessa regione del bucket S3 e del job di analisi Amazon Comprehend. 1. Scegli l'**AWS CloudShell icona** o digita **AWS CloudShell**nella casella di **ricerca** nella barra di navigazione in alto per avviare un ambiente. **Nota** Quando viene AWS CloudShell avviato per la prima volta in una nuova finestra del browser, un pannello di benvenuto mostra ed elenca le funzionalità principali. La shell è pronta per l'interazione dopo aver chiuso questo pannello e viene visualizzato il prompt dei comandi. 1. Dopo aver preparato il terminale, scegli **Azioni** dal pannello di navigazione, quindi scegli **Carica file** dal menu. 1. Nella finestra di dialogo che si apre, scegli **Seleziona file**, quindi scegli il file Python 3 scaricato `converter.py` dal tuo dispositivo. Scegli **Carica**. 1. Nell' AWS CloudShell ambiente, inserisci il seguente comando: ``` python3 converter.py ``` 1. Quando l'interfaccia della shell richiede di **inserire il nome del bucket S3, inserisci il nome del bucket** S3 e premi invio. 1. Quando l'interfaccia della shell richiede di **inserire il percorso completo del file di output Comprehend**, immettere e premere invio. **output** 1. Quando l'interfaccia della shell richiede di inserire il **percorso completo del file nella cartella dei metadati, inserisci** e premi invio. **metadata/** **Importante** Affinché i metadati siano formattati correttamente, i valori di input nei passaggi 8-10 devono essere esatti. ### Per eseguire lo script Python 3 ()AWS CLI 1. Per scaricare il file Python 3`converter.py`, esegui il seguente comando in una finestra di terminale: ------ #### [ Linux ] ``` curl -o path/converter.py.zip https://docs.aws.amazon.com/kendra/latest/dg/samples/converter.py.zip ``` Dove: + *path/*è il percorso del file nella posizione in cui si desidera salvare il file compresso. ------ #### [ macOS ] ``` curl -o path/converter.py.zip https://docs.aws.amazon.com/kendra/latest/dg/samples/converter.py.zip ``` Dove: + *path/*è il percorso del file nella posizione in cui si desidera salvare il file compresso. ------ #### [ Windows ] ``` curl -o path/converter.py.zip https://docs.aws.amazon.com/kendra/latest/dg/samples/converter.py.zip ``` Dove: + *path/*è il percorso del file nella posizione in cui si desidera salvare il file compresso. ------ 1. Per estrarre il file Python 3, esegui il seguente comando nella finestra del terminale: ------ #### [ Linux ] ``` unzip path/converter.py.zip -d path/ ``` Dove: + *path/*è il percorso del file salvato. `converter.py.zip` ------ #### [ macOS ] ``` unzip path/converter.py.zip -d path/ ``` Dove: + *path/*è il percorso del file salvato. `converter.py.zip` ------ #### [ Windows ] ``` tar -xf path/converter.py.zip -C path/ ``` Dove: + *path/*è il percorso del file salvato. `converter.py.zip` ------ 1. Assicurati che Boto3 sia installato sul tuo dispositivo eseguendo il seguente comando. ------ #### [ Linux ] ``` pip3 show boto3 ``` ------ #### [ macOS ] ``` pip3 show boto3 ``` ------ #### [ Windows ] ``` pip3 show boto3 ``` ------ **Nota** Se non hai Boto3 installato, `pip3 install boto3` esegui per installarlo. 1. Per eseguire lo script Python 3 per convertire il `output` file, esegui il comando seguente. ------ #### [ Linux ] ``` python path/converter.py ``` Dove: + *path/*è il percorso del file salvato. `converter.py.zip` ------ #### [ macOS ] ``` python path/converter.py ``` Dove: + *path/*è il percorso del file salvato. `converter.py.zip` ------ #### [ Windows ] ``` python path/converter.py ``` Dove: + *path/*è il percorso del file salvato. `converter.py.zip` ------ 1. Quando AWS CLI ti viene richiesto`Enter the name of your S3 bucket`, inserisci il nome del tuo bucket S3 e premi invio. 1. Quando ti viene AWS CLI richiesto, inserisci e premi invio. `Enter the full filepath to your Comprehend output file` **output** 1. Quando AWS CLI ti viene richiesto`Enter the full filepath to your metadata folder`, inserisci **metadata/** e premi invio. **Importante** Affinché i metadati siano formattati correttamente, i valori di input nei passaggi 5-7 devono essere esatti. Al termine di questo passaggio, i metadati formattati vengono depositati all'interno della cartella del `metadata` bucket S3. ## Pulizia del bucket Amazon S3 Poiché l'indice Amazon Kendra sincronizza tutti i file archiviati in un bucket, ti consigliamo di ripulire il bucket Amazon S3 per evitare risultati di ricerca ridondanti. ### Per pulire il bucket Amazon S3 (console) 1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. In **Buckets**, scegli il tuo bucket, quindi seleziona la cartella di output dell'analisi delle entità Amazon Comprehend, il file di analisi delle entità Amazon Comprehend e il file estratto di Amazon Comprehend. `.temp` `output` 1. ****Dalla scheda Panoramica scegli Elimina.**** 1. In **Eliminare oggetti**, scegli **Eliminare definitivamente gli oggetti?** e inserisci **permanently delete** nel campo di immissione del testo. 1. Scegliere **Delete objects (Elimina oggetti)**. ### Per pulire il bucket Amazon S3 ()AWS CLI 1. Per eliminare tutti i file e le cartelle nel bucket S3 tranne le `metadata` cartelle `data` and, usa il comando [remove](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/rm.html) in: AWS CLI ------ #### [ Linux ] ``` aws s3 rm s3://amzn-s3-demo-bucket/ --recursive --exclude "data/*" --exclude "metadata/*" ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ #### [ macOS ] ``` aws s3 rm s3://amzn-s3-demo-bucket/ --recursive --exclude "data/*" --exclude "metadata/*" ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ #### [ Windows ] ``` aws s3 rm s3://amzn-s3-demo-bucket/ --recursive --exclude "data/*" --exclude "metadata/*" ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ 1. [Per assicurarti che gli oggetti siano stati eliminati correttamente dal tuo bucket S3, controllane il contenuto usando il comando list:](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html) ------ #### [ Linux ] ``` aws s3 ls s3://amzn-s3-demo-bucket/ ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ #### [ macOS ] ``` aws s3 ls s3://amzn-s3-demo-bucket/ ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ #### [ Windows ] ``` aws s3 ls s3://amzn-s3-demo-bucket/ ``` Dove: + amzn-s3-demo-bucket è il nome del tuo bucket S3. ------ Al termine di questo passaggio, hai convertito l'output di analisi delle entità Amazon Comprehend in metadati Amazon Kendra. Ora sei pronto per creare un indice Amazon Kendra.