View a markdown version of this page

Tutorial: Guida introduttiva ad Amazon OpenSearch Serverless - OpenSearch Servizio Amazon
Fase 1: configurazione delle autorizzazioniFase 2: creazione di una raccoltaFase 3: Caricamento e ricerca dei datiGestione degli erroriFase 4: Eliminazione della raccoltaFasi successive

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

Tutorial: Guida introduttiva ad Amazon OpenSearch Serverless

Questo tutorial mostra i passaggi di base per rendere operativa rapidamente una raccolta di ricerca Amazon OpenSearch Serverless. Con una raccolta di ricerche, puoi potenziare le applicazioni nelle tue reti interne e le applicazioni connesse a Internet, come la ricerca di siti di e-commerce e la ricerca di contenuti.

Per informazioni su come utilizzare una raccolta di ricerca vettoriale, consulta. Lavorare con le raccolte di ricerca vettoriale Per informazioni più dettagliate sull'uso delle raccolte, consulta Gestione delle raccolte Amazon OpenSearch Serverless e gli altri argomenti di questa guida.

Completate i seguenti passaggi in questo tutorial:

  1. Configurazione delle autorizzazioni

  2. Creazione di una raccolta

  3. Caricamento e ricerca dei dati

  4. Eliminazione della raccolta

    Nota

    Usa solo caratteri ASCII per il tuoIndexName. Se non utilizzi caratteri ASCII per il tuoIndexName, la CloudWatch metrica IndexName in viene convertita in un formato con codifica URL per caratteri non ASCII.

Fase 1: configurazione delle autorizzazioni

Per completare questo tutorial e utilizzare OpenSearch Serverless in generale, devi disporre delle autorizzazioni IAM corrette. In questo tutorial, crei una raccolta, carichi e cerchi dati, quindi elimini la raccolta.

L'utente o il ruolo devono avere una policy basata sull'identità allegata con le seguenti autorizzazioni minime:

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Action": [
        "aoss:CreateCollection",
        "aoss:ListCollections",
        "aoss:BatchGetCollection",
        "aoss:DeleteCollection",
        "aoss:CreateAccessPolicy",
        "aoss:ListAccessPolicies",
        "aoss:UpdateAccessPolicy",
        "aoss:CreateSecurityPolicy",
        "aoss:GetSecurityPolicy",
        "aoss:UpdateSecurityPolicy",
        "iam:ListUsers",
        "iam:ListRoles"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Per ulteriori informazioni sulle autorizzazioni IAM OpenSearch Serverless, consulta. Identity and Access Management per Amazon OpenSearch Serverless

Fase 2: creazione di una raccolta

Una raccolta è un gruppo di OpenSearch indici che interagiscono per supportare un carico di lavoro o un caso d'uso specifici.

Per creare una raccolta Serverless OpenSearch

  1. Apri la console Amazon OpenSearch Service all'indirizzo https://console.aws.amazon.com/aos/home.

  2. Nel riquadro di navigazione a sinistra, scegli Raccolte.

  3. Scegli Create collection (Crea raccolta).

  4. In Nome, inserisci movies.

  5. Per Tipo di raccolta, scegli Cerca. Per ulteriori informazioni, consulta Scelta di un tipo di raccolta.

  6. Per il metodo di creazione della raccolta, scegli Express Create.

  7. Verificare le impostazioni predefinite. Questi includono il gruppo di raccolta, le impostazioni dell'applicazione dell' OpenSearchinterfaccia utente, la crittografia con un Chiave di proprietà di AWS, l'accesso alla rete pubblica e la politica di accesso ai dati generata automaticamente.

  8. Scegli Create collection (Crea raccolta).

  9. Attendi che lo stato della raccolta passi aActive. Questo processo potrebbe richiedere diversi minuti.

Suggerimento

Questo tutorial utilizza il metodo NextGen Express Create. Puoi accedere a Express Create anche dal pulsante Express create nel banner informativo sulla pagina di destinazione per un percorso più rapido. Per un maggiore controllo sulle impostazioni di crittografia, rete e accesso ai dati, usa Standard Create. Per utilizzare la procedura guidata di creazione della raccolta Classic, scegli Passa alla versione classica. Per ulteriori informazioni, consulta Creazione di raccolte.

Fase 3: Caricamento e ricerca dei dati

Puoi caricare dati in una raccolta OpenSearch Serverless utilizzando Postman o cURL. Per semplicità, questi esempi utilizzano Dev Tools all'interno della OpenSearch console Dashboards.

Indicizzazione e ricerca dei dati nella raccolta movies

  1. Scegli Collections (Raccolte) nel pannello di navigazione a sinistra e seleziona la raccolta movies per aprire la rispettiva pagina dei dettagli.

  2. Scegli l'URL delle OpenSearch dashboard per la raccolta. L'URL assume il formato https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}.

  3. All'interno di OpenSearch Dashboards, apri il riquadro di navigazione a sinistra e scegli Dev Tools.

  4. Per creare un singolo indice denominato movies-index, invia la seguente richiesta:

    PUT movies-index
    OpenSearch Console di dashboard che mostra la richiesta PUT a movies-index con stato di risposta 200.

  5. Per indicizzare un singolo documento in movies-index, invia la seguente richiesta:

    PUT movies-index/_doc/1
{ 
  "title": "Shawshank Redemption",
  "genre": "Drama",
  "year": 1994
}

  6. Per cercare dati nei OpenSearch dashboard, devi configurare almeno un modello di indice. OpenSearch utilizza questi modelli per identificare gli indici da analizzare. Apri il pannello di navigazione a sinistra, scegli Stack Management (Gestione stack), scegli Index Patterns (Modelli di indice), quindi scegli Create index pattern (Crea modello di indice). Per questo tutorial, digita movies.

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

  8. Per iniziare a cercare i dati, apri nuovamente il riquadro di navigazione a sinistra e scegli Scopri oppure utilizza l'API di ricerca all'interno di Dev Tools.

Gestione degli errori

Quando esegui operazioni di indicizzazione e ricerca, potresti ricevere le seguenti risposte di errore:

  • HTTP 507— Indica che si è verificato un errore interno del server. Questo errore indica in genere che le unità di OpenSearch calcolo (OCU) sono sovraccaricate dal volume o dalla complessità delle richieste. Sebbene OpenSearch Serverless sia scalabile automaticamente per gestire il carico, può verificarsi un ritardo nella distribuzione di risorse aggiuntive.

    Per mitigare questo errore, implementa una politica esponenziale di backoff e ripetizione dei tentativi. Questo approccio riduce temporaneamente la frequenza delle richieste per gestire efficacemente il carico. Per maggiori dettagli, consulta il comportamento Retry nella Guida di riferimento agli AWS SDK e agli strumenti.

  • HTTP 402— Indica che hai raggiunto il limite di capacità dell'unità di OpenSearch calcolo massima (OCU). Ottimizza il carico di lavoro per ridurre l'utilizzo dell'OCU o richiedere un aumento della quota.

Fase 4: Eliminazione della raccolta

Poiché la raccolta di film è a scopo di test, eliminala quando hai finito di sperimentare.

Per eliminare una raccolta OpenSearch Serverless

  1. Torna alla console di Amazon OpenSearch Service.

  2. Scegli Collections (Raccolte) nel pannello di navigazione a sinistra e seleziona la raccolta movies.

  3. Scegli Elimina e conferma l'eliminazione.

Fasi successive

Ora che sai come creare una raccolta e indicizzare i dati, potresti provare quanto segue: