Guida introduttiva ad AmazonOpenSearchServizio - OpenSearch Servizio Amazon
Fase 1: Creazione di un dominioFase 2: Caricamento dei dati per l'indicizzazioneFase 3: Ricerca di documentiFase 4: Eliminazione di un dominio

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

Guida introduttiva ad AmazonOpenSearchServizio

Questo tutorial ti mostra come usare AmazonOpenSearchServizio per creare e configurare un dominio di test. UnOpenSearchIl dominio di servizio è sinonimo diOpenSearchgrappolo. I domini sono cluster con le impostazioni, i tipi di istanza, il numero di istanze e le risorse di archiviazione specificate.

Questo tutorial ti guida attraverso i passaggi di base per ottenere unOpenSearchDominio di servizio attivo e funzionante rapidamente. Per informazioni più dettagliate, consulta Creazione e gestione di domini Amazon OpenSearch Service e altri argomenti all'interno di questa guida. Per informazioni sulla migrazione aOpenSearchServizio fornito da un sistema autogestitoOpenSearchcluster, vediTutorial: migrazione ad AmazonOpenSearchServizio.

Puoi completare i passaggi di questo tutorial utilizzando ilOpenSearchConsole di servizio,AWS CLI, o ilAWSSDK. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consultare la Guida per l'utente di AWS Command Line Interface.

Fase 1: Crea un AmazonOpenSearchDominio del servizio

Importante

Questo è un breve tutorial per configurare untestAmazonOpenSearchDominio del servizio. Non utilizzare questo processo per creare domini di produzione. Per una versione completa della stessa procedura, consulta Creazione e gestione di domini Amazon OpenSearch Service.

UnOpenSearchIl dominio di servizio è sinonimo diOpenSearchgrappolo. I domini sono cluster con le impostazioni, i tipi di istanza, il numero di istanze e le risorse di archiviazione specificate. Puoi creare unOpenSearchDominio del servizio utilizzando la console,AWS CLI, o ilAWSSDK.

Per creare unOpenSearchDominio del servizio che utilizza la console

  1. Passare all'indirizzo https://aws.amazon.com e scegliere Sign In to the Console (Accedi alla console).

  2. Sottoanalitica, scegliAmazonOpenSearchServizio.

  3. Scegli Crea dominio.

  4. Specificare un nome per il dominio. Gli esempi di questo tutorial utilizzano il nome movies.

  5. Per il metodo di creazione del dominio, scegliCreazione standard.

    Nota

    Per configurare rapidamente un dominio di produzione con le migliori pratiche, puoi scegliereFacile da creare. Per lo sviluppo e il test di questo tutorial, useremoCreazione standard.

  6. Per i modelli, scegliSviluppo/test.

  7. Per l'opzione di distribuzione, scegliDominio con standby.

  8. Per Versione, scegliere la versione più recente.

  9. Per ora, ignora ilNodi dati,Archiviazione dati a caldo e a freddo,Nodi master dedicati,Configurazione delle istantanee, eEndpoint personalizzatosezioni.

  10. Per semplicità in questo tutorial, viene utilizzato un dominio ad accesso pubblico. In Rete, scegli Accesso pubblico.

  11. Nelle impostazioni di controllo degli accessi dettagliate, mantieni ilAbilita un controllo degli accessi granularecasella di controllo selezionata. SelezionaCrea utente principalee fornisci un nome utente e una password.

  12. Per adesso, ignorare le sezioni Autenticazione SAML e Autenticazione Amazon Cognito.

  13. Per Policy di accesso, scegli Utilizza solo controllo granulare degli accessi. In questa esercitazione, il controllo granulare degli accessi gestisce l'autenticazione, non la policy di accesso al dominio.

  14. Ignora il resto delle impostazioni per il momento e scegli Crea. I nuovi domini richiedono in genere 15-30 minuti per l'inizializzazione, ma possono richiedere più tempo a seconda della configurazione. Dopo l'inizializzazione del dominio, selezionarlo per aprire il riquadro di configurazione. Annotare l'endpoint del dominio sotto Informazioni generali (ad esempio,https://search-my-domain.us-east-1.es.amazonaws.com), che potrai utilizzare nel prossimo passaggio.

Prossimo:Caricare i dati su unOpenSearchDominio di servizio per l'indicizzazione

Fase 2: Caricare i dati su AmazonOpenSearchServizio di indicizzazione

Importante

Questo è un breve tutorial per caricare una piccola quantità di dati di test su AmazonOpenSearchServizio. Per ulteriori informazioni sul caricamento dei dati in un dominio di produzione, consultare Indicizzazione dei dati in Amazon Service OpenSearch .

Puoi caricare i dati su unOpenSearchDominio del servizio che utilizza la riga di comando o la maggior parte dei linguaggi di programmazione.

Per brevità e comodità, le richieste di esempio seguenti utilizzano curl, un comune client HTTP. I client come curl non sono in grado di eseguire la firma della richiesta, necessaria se la policy d'accesso specifica utenti o ruoli IAM. Per completare correttamente questo processo, è necessario utilizzare un controllo di accesso granulare con un nome utente e una password primari come quelli configurati inFase 1.

È possibile installare curl su Windows e utilizzarlo dal prompt dei comandi, ma consigliamo di utilizzare uno strumento come Cygwin o Windows Subsystem for Linux. I sistemi macOS e la maggior parte delle distribuzioni Linux includono già curl.

Opzione 1: Caricamento di un singolo documento

Esegui il comando seguente per aggiungere un singolo documento al dominio movies:

curl -XPUT -u 'master-user:master-user-password' 'domain-endpoint/movies/_doc/1' -d '{"director": "Burton, Tim", "genre": ["Comedy","Sci-Fi"], "year": 1996, "actor": ["Jack Nicholson","Pierce Brosnan","Sarah Jessica Parker"], "title": "Mars Attacks!"}' -H 'Content-Type: application/json'

Nel comando, inserisci il nome utente e la password che hai creato inFase 1.

Per una spiegazione dettagliata di questo comando e di come effettuare richieste firmate aOpenSearchAssistenza, vediIndicizzazione dei dati in Amazon Service OpenSearch .

Opzione 2: Caricamento di più documenti

Per caricare un file JSON che contiene più documenti su unOpenSearchDominio del servizio

  1. Creare un file locale denominato bulk_movies.json. Copiare e incollare il seguente contenuto nel file e aggiungere un carattere newline finale:

    { "index" : { "_index": "movies", "_id" : "2" } }
{"director": "Frankenheimer, John", "genre": ["Drama", "Mystery", "Thriller", "Crime"], "year": 1962, "actor": ["Lansbury, Angela", "Sinatra, Frank", "Leigh, Janet", "Harvey, Laurence", "Silva, Henry", "Frees, Paul", "Gregory, James", "Bissell, Whit", "McGiver, John", "Parrish, Leslie", "Edwards, James", "Flowers, Bess", "Dhiegh, Khigh", "Payne, Julie", "Kleeb, Helen", "Gray, Joe", "Nalder, Reggie", "Stevens, Bert", "Masters, Michael", "Lowell, Tom"], "title": "The Manchurian Candidate"}
{ "index" : { "_index": "movies", "_id" : "3" } }
{"director": "Baird, Stuart", "genre": ["Action", "Crime", "Thriller"], "year": 1998, "actor": ["Downey Jr., Robert", "Jones, Tommy Lee", "Snipes, Wesley", "Pantoliano, Joe", "Jacob, Ir\u00e8ne", "Nelligan, Kate", "Roebuck, Daniel", "Malahide, Patrick", "Richardson, LaTanya", "Wood, Tom", "Kosik, Thomas", "Stellate, Nick", "Minkoff, Robert", "Brown, Spitfire", "Foster, Reese", "Spielbauer, Bruce", "Mukherji, Kevin", "Cray, Ed", "Fordham, David", "Jett, Charlie"], "title": "U.S. Marshals"}
{ "index" : { "_index": "movies", "_id" : "4" } }
{"director": "Ray, Nicholas", "genre": ["Drama", "Romance"], "year": 1955, "actor": ["Hopper, Dennis", "Wood, Natalie", "Dean, James", "Mineo, Sal", "Backus, Jim", "Platt, Edward", "Ray, Nicholas", "Hopper, William", "Allen, Corey", "Birch, Paul", "Hudson, Rochelle", "Doran, Ann", "Hicks, Chuck", "Leigh, Nelson", "Williams, Robert", "Wessel, Dick", "Bryar, Paul", "Sessions, Almira", "McMahon, David", "Peters Jr., House"], "title": "Rebel Without a Cause"}

  2. Eseguire il comando seguente nella directory locale in cui è memorizzato il file per caricarlo nel dominio movies:

    curl -XPOST -u 'master-user:master-user-password' 'domain-endpoint/_bulk' --data-binary @bulk_movies.json -H 'Content-Type: application/json'

Per ulteriori informazioni sul formato di file bulk, consulta Indicizzazione dei dati in Amazon Service OpenSearch

Successivo: Ricerca di documenti

Fase 3: Cerca documenti in AmazonOpenSearchServizio

Per cercare documenti su AmazonOpenSearchDominio del servizio, usa ilOpenSearchAPI di ricerca. In alternativa, puoi usareOpenSearchPannelli di controlloper cercare documenti nel dominio.

Come eseguire la ricerca di documenti dalla riga di comando

Esegui il comando seguente per cercare la parola mars nel dominio movies:

curl -XGET -u 'master-user:master-user-password' 'domain-endpoint/movies/_search?q=mars&pretty=true'

Se nella pagina precedente hai utilizzato il blocco di dati, prova a cercare invece rebel.

Noterai una risposta simile alla seguente:

{
  "took" : 5,
  "timed_out" : false,
  "_shards" : {
    "total" : 5,
    "successful" : 5,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 1,
      "relation" : "eq"
    },
    "max_score" : 0.2876821,
    "hits" : [
      {
        "_index" : "movies",
        "_type" : "_doc",
        "_id" : "1",
        "_score" : 0.2876821,
        "_source" : {
          "director" : "Burton, Tim",
          "genre" : [
            "Comedy",
            "Sci-Fi"
          ],
          "year" : 1996,
          "actor" : [
            "Jack Nicholson",
            "Pierce Brosnan",
            "Sarah Jessica Parker"
          ],
          "title" : "Mars Attacks!"
        }
      }
    ]
  }
}

Cerca documenti utilizzandoOpenSearchPannelli di controllo

OpenSearchDashboards è un popolare strumento di visualizzazione open source progettato per funzionare conOpenSearch. Fornisce un'interfaccia utente utile per cercare e monitorare gli indici.

Per cercare documenti da unOpenSearchDominio del servizio tramite dashboard

  1. Accedere allaOpenSearchURL delle dashboard per il tuo dominio. Puoi trovare l'URL nella dashboard del dominio nelOpenSearchConsole di servizio. L'URL segue il seguente formato:

    domain-endpoint/_dashboards/

  2. Accedi utilizzando il tuo nome utente e la password principali.

  3. Per utilizzare Dashboards, è necessario creare almeno un modello di indice. Dashboards usa questi modelli per identificare gli indici da analizzare. Aprire il riquadro di spostamento a sinistra, scegliere Gestione stack, scegliere Modelli di indice, quindi scegliere Crea modello di indice. Per questo tutorial, digita movies.

  4. Scegliere Fase successiva quindi selezionare Crea modello di indice. Dopo aver creato il modello, è possibile visualizzare i vari campi del documento, ad esempio actor e director.

  5. Tornare alla pagina Modelli di indice e assicurarsi che movies sia impostato come valore di default. In caso contrario, seleziona il modello e scegli l'icona a forma di stella per renderlo predefinito.

  6. Per iniziare a cercare i dati, aprire di nuovo il riquadro di spostamento a sinistra e scegliere Individua.

  7. Nella barra di ricerca, inserire mars se è stato caricato un singolo documento oppure rebel se sono stati caricati più documenti, quindi premere Invio. È possibile provare a cercare altri termini, come i nomi di attori o registi.

Successivo: Eliminazione di un dominio

Fase 4: Eliminare un AmazonOpenSearchDominio del servizio

Poiché il dominio movies utilizzato in questo tutorial è solo a scopo di test, è consigliabile eliminarlo una volta terminate le prove in modo da evitare costi aggiuntivi.

Per eliminare unOpenSearchDominio di servizio dalla console

  1. Accedi alAmazonOpenSearchServizioconsolle.

  2. In Domini, seleziona il dominio movies.

  3. Scegli Elimina e conferma l'eliminazione.

Fasi successive

Adesso che è chiaro come creare un dominio e i dati di indice, è possibile provare a completare alcuni degli esercizi seguenti: