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à. # Importazione e gestione di pacchetti in Amazon Service OpenSearch Amazon OpenSearch Service ti consente di caricare file di dizionario personalizzati, come parole chiave e sinonimi, e associare plugin al tuo dominio. Questi plugin possono essere preconfezionati, personalizzati o di terze parti, il che ti offre la flessibilità necessaria per estendere le funzionalità del tuo dominio. *Il termine generico per tutti questi tipi di file è pacchetti.* + **I file di dizionario** aiutano a perfezionare i risultati di ricerca indicando di OpenSearch ignorare le parole più comuni ad alta frequenza o di trattare termini simili, come «crema pasticcera congelata», «gelato» e «gelato», come equivalenti. Possono anche migliorare lo [stemming](https://en.wikipedia.org/wiki/Stemming), come si è visto con il plugin di analisi giapponese (kuromoji). + I **plug-in preconfezionati** offrono funzionalità integrate, come il plug-in Amazon Personalize per risultati di ricerca personalizzati. Questi plugin utilizzano il tipo di pacchetto. `ZIP-PLUGIN` Per ulteriori informazioni, consulta [Plugin per versione del motore in Amazon Service OpenSearch](supported-plugins.md). + **I plug-in personalizzati e di terze parti** consentono di aggiungere funzionalità personalizzate o di integrarsi con sistemi esterni, il che offre una flessibilità ancora maggiore per il dominio. Come i plugin preconfezionati, caricate i plugin personalizzati come pacchetti. `ZIP-PLUGIN` Per i plug-in di terze parti, è inoltre necessario importare la licenza del plug-in e i file di configurazione come pacchetti separati, quindi associarli tutti al dominio. Per ulteriori informazioni, consulta i seguenti argomenti: + [Gestione dei plugin personalizzati in Amazon Service OpenSearch](custom-plugins.md) + [Installazione di plug-in di terze parti in Amazon Service OpenSearch](plugins-third-party.md) **Nota** Puoi associare un massimo di 20 plugin a un singolo dominio. Questo limite include tutti i tipi di plug-in: plug-in opzionali, di terze parti e personalizzati. **Topics** + [Autorizzazioni richieste](#custom-packages-iam) + [Caricamento di pacchetti in Amazon S3](#custom-packages-gs) + [Importazione e associazione di pacchetti](#custom-packages-assoc) + [Utilizzo di pacchetti con OpenSearch](#custom-packages-using) + [Aggiornamento dei pacchetti](#custom-packages-updating) + [Aggiornamento manuale degli indici con un nuovo dizionario](#custom-packages-updating-index-analyzers) + [Dissociazione e rimozione dei pacchetti](#custom-packages-dissoc) + [Gestione dei plugin personalizzati in Amazon Service OpenSearch](custom-plugins.md) + [Installazione di plug-in di terze parti in Amazon Service OpenSearch](plugins-third-party.md) ## Autorizzazioni richieste Gli utenti senza accesso come amministratore richiedono determinate azioni AWS Identity and Access Management (IAM) per gestire i pacchetti: + `es:CreatePackage`— Creare un pacchetto + `es:DeletePackage`— Eliminare un pacchetto + `es:AssociatePackage`— Associare un pacchetto a un dominio + `es:DissociatePackage`— Dissociare un pacchetto da un dominio Sono necessarie anche le autorizzazioni per il percorso del bucket Amazon S3 o l'oggetto in cui si trova il pacchetto personalizzato. Concedere tutte le autorizzazioni all'interno di IAM, non nella policy di accesso al dominio. Per ulteriori informazioni, consultare [Identity and Access Management in Amazon OpenSearch Service](ac.md). ## Caricamento di pacchetti in Amazon S3 Questa sezione spiega come caricare pacchetti di dizionari personalizzati, poiché i pacchetti di plug-in preconfezionati sono già installati. Prima di poter associare un dizionario personalizzato al tuo dominio, devi caricarlo in un bucket Amazon S3. Per le istruzioni, consulta [Caricamento di oggetti](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) nella *Guida per l'utente di Amazon Simple Storage Service*. I plugin supportati non devono essere caricati. Se il dizionario contiene informazioni sensibili, specifica la [crittografia lato server con chiavi gestite da S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingServerSideEncryption.html) al momento del caricamento. OpenSearch Il servizio non può accedere ai file in S3 che proteggi utilizzando una chiave. AWS KMS Dopo aver caricato il file, prendere nota del suo percorso S3. Il formato del percorso è `s3://amzn-s3-demo-bucket/file-path/file-name`. È possibile utilizzare il seguente file di sinonimi per scopi di test. Salvalo come `synonyms.txt`. ``` danish, croissant, pastry ice cream, gelato, frozen custard sneaker, tennis shoe, running shoe basketball shoe, hightop ``` Alcuni dizionari, come i dizionari Hunspell, utilizzano più file e richiedono le proprie directory nel file system. Al momento, OpenSearch Service supporta solo dizionari a file singolo. ## Importazione e associazione di pacchetti La console è il modo più semplice per importare un dizionario personalizzato in Service. OpenSearch Quando importi un dizionario da Amazon S3, OpenSearch Service archivia la propria copia del pacchetto e la crittografa automaticamente utilizzando AES-256 con chiavi gestite dal servizio. OpenSearch I plug-in opzionali sono già preinstallati in OpenSearch Service, quindi non è necessario caricarli personalmente, ma è necessario associare un plug-in a un dominio. I plugin disponibili sono elencati nella schermata **Pacchetti** della console. ### Importa e associa un pacchetto a un dominio 1. Nella console di Amazon OpenSearch Service, scegli **Pacchetti**. 1. Scegli **Importa pacchetto**. 1. Assegnare al pacchetto un nome descrittivo. 1. Fornire il percorso S3 del file e quindi scegliere **Importa**. 1. Tornare alla schermata **Pacchetti** . 1. Quando lo stato del pacchetto è **disponibile**, selezionarlo. 1. Scegli **Associa a un dominio**. 1. Seleziona un dominio, quindi scegli **Avanti**. Esamina i pacchetti e scegli **Associa**. 1. Nel pannello di navigazione, scegliere il dominio e passare alla scheda **Pacchetti**. 1. Se il pacchetto è un dizionario personalizzato, annota l'ID quando il pacchetto diventa **Disponibile**. Utilizza `analyzers/id` come percorso del file nelle [richieste di OpenSearch](#custom-packages-using). ## Utilizzo di pacchetti con OpenSearch Questa sezione spiega come utilizzare entrambi i tipi di pacchetti: dizionari personalizzati e plugin preconfezionati. ### Usare dizionari personalizzati Dopo aver associato un file a un dominio, è possibile utilizzarlo in parametri quali `synonyms_path` e `user_dictionary` quando si creano tokenizzatori e filtri token. `stopwords_path` Il parametro esatto varia in base all'oggetto. Diversi oggetti supportano `synonyms_path` e `stopwords_path`, ma `user_dictionary` è esclusivo per il plugin kuromoji. Per il plug-in IK (Chinese) Analysis, è possibile caricare un file di dizionario personalizzato come pacchetto personalizzato e associarlo a un dominio e il plug-in lo raccoglie automaticamente senza richiedere un parametro `user_dictionary`. Se il file è un file di sinonimi, usa il parametro `synonyms_path`. Nel seguente esempio viene aggiunto un file di sinonimi a un nuovo indice: ``` PUT my-index { "settings": { "index": { "analysis": { "analyzer": { "my_analyzer": { "type": "custom", "tokenizer": "standard", "filter": ["my_filter"] } }, "filter": { "my_filter": { "type": "synonym", "synonyms_path": "analyzers/F111111111", "updateable": true } } } } }, "mappings": { "properties": { "description": { "type": "text", "analyzer": "standard", "search_analyzer": "my_analyzer" } } } } ``` Questa richiesta crea un analizzatore personalizzato per l'indice che utilizza il tokenizer standard e un filtro token sinonimo. + I tokenizer scompongono i flussi di caratteri in *token* (in genere parole) in base ad alcune regole. L'esempio più semplice è il tokenizer di whitespace, che scompone i caratteri precedenti in un token ogni volta che incontra un carattere di whitespace. Un esempio più complesso è il tokenizer standard, che utilizza un insieme di regole grammaticali per lavorare in molte lingue. + I filtri token aggiungono, modificano o eliminano token. Ad esempio, un filtro token sinonimo aggiunge token quando trova una parola nell'elenco dei sinonimi. Il filtro token di arresto rimuove i token quando trova una parola nell'elenco di parole stop. Questa richiesta aggiunge anche un campo di testo (`description`) alla mappatura e indica di OpenSearch utilizzare il nuovo analizzatore come analizzatore di ricerca. Si può vedere che come analizzatore di indice è utilizzato ancora l'analizzatore standard. Infine, prendere nota della riga `"updateable": true` nel filtro token. Questo campo si applica solo agli analizzatori di ricerca non agli analizzatori di indice, ed è critico se in seguito si desidera [aggiornare l'analizzatore di ricerca](#custom-packages-updating) automaticamente. A scopo di test, aggiungere alcuni documenti all'indice: ``` POST _bulk { "index": { "_index": "my-index", "_id": "1" } } { "description": "ice cream" } { "index": { "_index": "my-index", "_id": "2" } } { "description": "croissant" } { "index": { "_index": "my-index", "_id": "3" } } { "description": "tennis shoe" } { "index": { "_index": "my-index", "_id": "4" } } { "description": "hightop" } ``` Quindi cercarli usando un sinonimo: ``` GET my-index/_search { "query": { "match": { "description": "gelato" } } } ``` In questo caso, OpenSearch restituisce la seguente risposta: ``` { "hits": { "total": { "value": 1, "relation": "eq" }, "max_score": 0.99463606, "hits": [{ "_index": "my-index", "_type": "_doc", "_id": "1", "_score": 0.99463606, "_source": { "description": "ice cream" } }] } } ``` **Suggerimento** I file di dizionario utilizzano lo spazio heap Java proporzionale alle loro dimensioni. Ad esempio, un file di dizionario a 2 GiB potrebbe consumare su un nodo 2 GiB di spazio heap. Se si utilizzano file di grandi dimensioni, assicurarsi che i nodi dispongano di spazio heap sufficiente per contenerli. [Monitorare](managedomains-cloudwatchmetrics.md#managedomains-cloudwatchmetrics-cluster-metrics) il parametro `JVMMemoryPressure` e dimensionare il cluster in base alle esigenze. ### Utilizzo di plugin preconfezionati OpenSearch Il servizio consente di associare OpenSearch plug-in opzionali preinstallati da utilizzare al dominio. Un pacchetto di plug-in preconfezionato è compatibile con una OpenSearch versione specifica e può essere associato solo a domini con quella versione. L'elenco dei pacchetti disponibili per il tuo dominio include tutti i plugin supportati compatibili con la versione del tuo dominio. Dopo aver associato un plug-in a un dominio, inizia un processo di installazione sul dominio. Quindi, puoi fare riferimento e utilizzare il plug-in quando effettui richieste al OpenSearch Servizio. L'associazione e la dissociazione di un plug-in richiedono una distribuzione. blue/green Per ulteriori informazioni, consulta [Modifiche che di solito causano implementazioni blue/green](managedomains-configuration-changes.md#bg). I plugin opzionali includono analizzatori linguistici e risultati di ricerca personalizzati. Ad esempio, il plug-in Amazon Personalize Search Ranking utilizza l'apprendimento automatico per personalizzare i risultati di ricerca per i tuoi clienti. Per ulteriori informazioni su questo plugin, consulta [Personalizzazione](https://docs.aws.amazon.com/personalize/latest/dg/personalize-opensearch.html) dei risultati di ricerca da. OpenSearch Per un elenco di tutti i plugin supportati, consulta. [Plugin per versione del motore in Amazon Service OpenSearch](supported-plugins.md) #### Plugin Sudachi Per il [plugin Sudachi](https://github.com/WorksApplications/elasticsearch-sudachi), quando riassoci un file di dizionario, questo non si riflette immediatamente sul dominio. Il dizionario si aggiorna quando viene eseguita la blue/green distribuzione successiva sul dominio come parte di una modifica della configurazione o di un altro aggiornamento. In alternativa, è possibile creare un nuovo pacchetto con i dati aggiornati, creare un nuovo indice utilizzando questo nuovo pacchetto, reindicizzare l'indice esistente nel nuovo indice e quindi eliminare il vecchio indice. Se preferisci utilizzare l'approccio di reindicizzazione, utilizza un alias di indice in modo da evitare interruzioni del traffico. Inoltre, il plugin Sudachi supporta solo dizionari binari Sudachi, che puoi caricare con l'operazione API. [CreatePackage](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_CreatePackage.html) [Per informazioni sul dizionario di sistema predefinito e sul processo di compilazione dei dizionari utente, consulta la documentazione Sudachi.](https://github.com/WorksApplications/elasticsearch-sudachi) **Nota** Quando carichi file di dizionario binario su Amazon S3, devi impostare il Content-Type dell'oggetto S3 su. `binary/octet-stream` L'utilizzo `application/octet-stream` farà fallire l'importazione del pacchetto. L'esempio seguente mostra come utilizzare i dizionari di sistema e utente con il tokenizer Sudachi. È necessario caricare questi dizionari come pacchetti personalizzati con tipo `TXT-DICTIONARY` e fornire il relativo pacchetto nelle impostazioni aggiuntive. IDs ``` PUT sudachi_sample { "settings": { "index": { "analysis": { "tokenizer": { "sudachi_tokenizer": { "type": "sudachi_tokenizer", "additional_settings": "{\"systemDict\": \"\",\"userDict\": [\"\"]}" } }, "analyzer": { "sudachi_analyzer": { "filter": ["my_searchfilter"], "tokenizer": "sudachi_tokenizer", "type": "custom" } }, "filter":{ "my_searchfilter": { "type": "sudachi_split", "mode": "search" } } } } } } ``` ## Aggiornamento dei pacchetti Questa sezione spiega solo come aggiornare un pacchetto di dizionario personalizzato, poiché i pacchetti di plugin preconfezionati sono già aggiornati automaticamente. Il caricamento di una nuova versione di un dizionario su Amazon S3 *non* aggiorna automaticamente il pacchetto su Amazon OpenSearch Service. OpenSearch Il servizio archivia la propria copia del file, quindi se carichi una nuova versione su S3, devi aggiornarla manualmente. Ciascuno dei domini associati archivia anche la *propria copia* del file. Per mantenere prevedibile il comportamento di ricerca, i domini continueranno a utilizzare la versione corrente del pacchetto fino a quando non vengono aggiornati esplicitamente. Per aggiornare un pacchetto personalizzato, modifica il file in Amazon S3 Control, aggiorna il pacchetto in OpenSearch Service, quindi applica l'aggiornamento. ### Console 1. Nella console OpenSearch di servizio, scegli **Pacchetti**. 1. Scegli un pacchetto, quindi seleziona **Aggiorna**. 1. Fornisci un nuovo percorso S3 al file, quindi scegli **Aggiorna pacchetto**. 1. Tornare alla schermata **Pacchetti** . 1. Quando lo stato del pacchetto è **Disponibile**, selezionarlo. Scegliere uno o più domini associati, selezionare **Applica aggiornamento** e confermare. Attendere che lo stato dell'associazione cambi in **Attivo**. 1. I passaggi successivi variano a seconda di come hai configurato gli indici: + Se il tuo dominio è in esecuzione OpenSearch con Elasticsearch 7.8 o versione successiva e utilizza solo analizzatori di ricerca con il campo [aggiornabile](#custom-packages-using) impostato su true, non devi intraprendere ulteriori azioni. OpenSearch [Il servizio aggiorna automaticamente gli indici utilizzando l'API \$1plugins/\$1refresh\$1search\$1analyzers.](https://docs.opensearch.org/latest/im-plugin/refresh-analyzer/index/) + Se il tuo dominio esegue Elasticsearch 7.7 o versioni precedenti, utilizza analizzatori di indici o non utilizza il campo, vedi. `updateable` [Aggiornamento manuale degli indici con un nuovo dizionario](#custom-packages-updating-index-analyzers) Sebbene la console sia il metodo più semplice, puoi anche utilizzare l'API SDKs, o di configurazione per AWS CLI aggiornare i pacchetti di servizi. OpenSearch Per ulteriori informazioni, consulta [AWS CLI Command Reference](https://docs.aws.amazon.com/cli/latest/reference/) e [Amazon OpenSearch Service API Reference](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html). ### AWS SDK Invece di aggiornare manualmente un pacchetto nella console, puoi utilizzare il SDKs per automatizzare il processo di aggiornamento. Il seguente script Python di esempio carica un nuovo file di pacchetto su Amazon S3, aggiorna il pacchetto in OpenSearch Service e applica il nuovo pacchetto al dominio specificato. Dopo aver verificato l'avvenuto aggiornamento, esegue una chiamata di esempio per OpenSearch dimostrare che i nuovi sinonimi sono stati applicati. È necessario fornire valori per `host`, `region`, `file_name`, `bucket_name`, `s3_key`, `package_id`, `domain_name` e `query`. ``` from requests_aws4auth import AWS4Auth import boto3 import requests import time import json import sys host = '' # The OpenSearch domain endpoint with https:// and a trailing slash. For example, https://my-test-domain.us-east-1.es.amazonaws.com/ region = '' # For example, us-east-1 file_name = '' # The path to the file to upload bucket_name = '' # The name of the S3 bucket to upload to s3_key = '' # The name of the S3 key (file name) to upload to package_id = '' # The unique identifier of the OpenSearch package to update domain_name = '' # The domain to associate the package with query = '' # A test query to confirm the package has been successfully updated service = 'es' credentials = boto3.Session().get_credentials() client = boto3.client('opensearch') awsauth = AWS4Auth(credentials.access_key, credentials.secret_key, region, service, session_token=credentials.token) def upload_to_s3(file_name, bucket_name, s3_key): """Uploads file to S3""" s3 = boto3.client('s3') try: s3.upload_file(file_name, bucket_name, s3_key) print('Upload successful') return True except FileNotFoundError: sys.exit('File not found. Make sure you specified the correct file path.') def update_package(package_id, bucket_name, s3_key): """Updates the package in OpenSearch Service""" print(package_id, bucket_name, s3_key) response = client.update_package( PackageID=package_id, PackageSource={ 'S3BucketName': bucket_name, 'S3Key': s3_key } ) print(response) def associate_package(package_id, domain_name): """Associates the package to the domain""" response = client.associate_package( PackageID=package_id, DomainName=domain_name) print(response) print('Associating...') def wait_for_update(domain_name, package_id): """Waits for the package to be updated""" response = client.list_packages_for_domain(DomainName=domain_name) package_details = response['DomainPackageDetailsList'] for package in package_details: if package['PackageID'] == package_id: status = package['DomainPackageStatus'] if status == 'ACTIVE': print('Association successful.') return elif status == 'ASSOCIATION_FAILED': sys.exit('Association failed. Please try again.') else: time.sleep(10) # Wait 10 seconds before rechecking the status wait_for_update(domain_name, package_id) def sample_search(query): """Makes a sample search call to OpenSearch""" path = '_search' params = {'q': query} url = host + path response = requests.get(url, params=params, auth=awsauth) print('Searching for ' + '"' + query + '"') print(response.text) ``` **Nota** Se ricevi un errore «pacchetto non trovato» quando esegui lo script utilizzando il AWS CLI, probabilmente significa che Boto3 sta utilizzando la regione specificata in \$1/.aws/config, che non è la regione in cui si trova il bucket S3. Esegui `aws configure` e specifica la regione corretta oppure aggiungi esplicitamente la regione al client: ``` client = boto3.client('opensearch', region_name='us-east-1') ``` ## Aggiornamento manuale degli indici con un nuovo dizionario Gli aggiornamenti manuali degli indici si applicano solo ai dizionari personalizzati, non ai plugin preconfezionati. Per utilizzare un dizionario aggiornato, è necessario aggiornare manualmente gli indici se si soddisfa una delle seguenti condizioni: + Il dominio esegue Elasticsearch 7.7 o versioni precedenti. + I pacchetti personalizzati vengono utilizzati come analizzatori di indice. + I pacchetti personalizzati vengono utilizzati come analizzatori di ricerca, ma non includono il campo [aggiornabile](#custom-packages-using). Per aggiornare gli analizzatori con i file del nuovo pacchetto, sono disponibili due opzioni: + Chiudi e apri gli indici da aggiornare: ``` POST my-index/_close POST my-index/_open ``` + Reindicizzare gli indici. Innanzitutto, create un indice che utilizzi il file dei sinonimi aggiornato (o un file completamente nuovo). Nota che è supportato solo UTF-8. ``` PUT my-new-index { "settings": { "index": { "analysis": { "analyzer": { "synonym_analyzer": { "type": "custom", "tokenizer": "standard", "filter": ["synonym_filter"] } }, "filter": { "synonym_filter": { "type": "synonym", "synonyms_path": "analyzers/F222222222" } } } } }, "mappings": { "properties": { "description": { "type": "text", "analyzer": "synonym_analyzer" } } } } ``` Quindi [reindicizzare](https://docs.opensearch.org/latest/opensearch/reindex-data/) il vecchio indice nel nuovo indice: ``` POST _reindex { "source": { "index": "my-index" }, "dest": { "index": "my-new-index" } } ``` Se gli analizzatori di indice vengono aggiornati con una certa frequenza, utilizzare gli [alias di indice](https://docs.opensearch.org/latest/opensearch/index-alias/) per mantenere un percorso coerente per l'indice più recente: ``` POST _aliases { "actions": [ { "remove": { "index": "my-index", "alias": "latest-index" } }, { "add": { "index": "my-new-index", "alias": "latest-index" } } ] } ``` Se il vecchio indice non è necessario, eliminarlo. ``` DELETE my-index ``` ## Dissociazione e rimozione dei pacchetti La dissociazione di un pacchetto, che si tratti di un dizionario personalizzato o di un plug-in preconfezionato, da un dominio significa che non è più possibile utilizzare quel pacchetto quando si creano nuovi indici. Dopo la dissociazione di un pacchetto, gli indici esistenti che lo utilizzavano non possono più utilizzarlo. È necessario rimuovere il pacchetto da qualsiasi indice prima di poterlo dissociare, altrimenti la dissociazione fallisce. La console è il modo più semplice per dissociare un pacchetto da un dominio e rimuoverlo dal servizio. OpenSearch La rimozione di un pacchetto dal OpenSearch servizio *non* lo rimuove dalla sua posizione originale su Amazon S3. ### Dissocia un pacchetto da un dominio 1. Accedi alla console di Amazon OpenSearch Service da [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home). 1. Nel riquadro di navigazione, scegli **Domini**. 1. Scegli il dominio, quindi vai alla scheda **Pacchetti**. 1. Scegliere un pacchetto, selezionare **Operazioni**, quindi scegliere **Dissocia**. Conferma la tua scelta. 1. Attendi che il pacchetto scompaia dall'elenco. Potrebbe essere necessario aggiornare il browser. 1. Se desideri utilizzare il pacchetto con altri domini, interrompi questa operazione a questo punto. Per continuare a rimuovere il pacchetto (se si tratta di un dizionario personalizzato), scegli **Pacchetti** nel riquadro di navigazione. 1. Seleziona il pacchetto e scegli **Elimina**. In alternativa, usa l'API AWS CLI SDKs, o configuration per dissociare e rimuovere i pacchetti. Per ulteriori informazioni, consulta [AWS CLI Command Reference](https://docs.aws.amazon.com/cli/latest/reference/) e [Amazon OpenSearch Service API Reference](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).