Passaggio 3: cerca il tuo CloudSearch dominio Amazon

Puoi utilizzare il search tester nella CloudSearch console Amazon per inviare richieste di ricerca di esempio e visualizzare i risultati. Puoi anche inviare esempi di richieste di ricerca tramite un browser Web o utilizzando cURL. Nella tua applicazione, puoi utilizzare qualsiasi HTTP libreria per inviare traffico di ricerca al tuo CloudSearch dominio Amazon.

Ricerca con il test di ricerca

Il tester di ricerca nella CloudSearch console Amazon ti consente di inviare richieste di ricerca di esempio utilizzando uno qualsiasi dei parser di query supportati: simple, structured, lucene o dismax. Per impostazione predefinita, le richieste vengono elaborate con il semplice parser di query. È possibile specificare le opzioni per il parser selezionato, filtrare e ordinare i risultati e sfogliare i facet configurati. I risultati della ricerca vengono evidenziati automaticamente nei risultati della ricerca. Per informazioni su come eseguire questa operazione, vedereEvidenziazione dei risultati di ricerca in Amazon CloudSearch. Puoi anche selezionare un suggeritore per ricevere suggerimenti man mano che inserisci i termini nel campo di ricerca. (È necessario configurare un suggeritore prima di poter ricevere suggerimenti. Per ulteriori informazioni, vedereRicevere suggerimenti di completamento automatico in Amazon CloudSearch.)

Per impostazione predefinita, i risultati vengono ordinati in base a un punteggio di pertinenza generato automaticamente, _score. Per informazioni sulla personalizzazione del modo in cui vengono classificati i risultati, consulta. Ordinamento dei risultati in Amazon CloudSearch

Per cercare nel tuo dominio

1. Vai alla CloudSearch console Amazon a https://console.aws.amazon.com/cloudsearch/casa.

2. Nel pannello di navigazione a sinistra, scegli il dominio dei tuoi film per aprirne la configurazione.

3. Scegli Esegui una ricerca di prova.

4. Per eseguire una semplice ricerca testuale, inserisci una query di ricerca e scegli Esegui. Per impostazione predefinita, la ricerca viene effettuata in tutti text text-array i campi.

Per cercare campi particolari, espandi Opzioni e inserisci un elenco separato da virgole dei campi che desideri cercare nel campo Campi di ricerca. Puoi aggiungere un peso a ciascun campo con un cursore (^) per controllare l'importanza relativa di ogni campo nei risultati della ricerca. Ad esempio, quando si calcolano i punteggi di pertinenza per ogni documento corrispondente, è possibile specificare i title^5, description pesi ottenuti nel title description campo cinque volte in più rispetto ai risultati ottenuti nel campo.

Per utilizzare la sintassi delle query strutturate, selezionate Structured dal menu Query parser. Dopo aver selezionato il parser di query strutturato, inserisci la query strutturata nel campo Cerca e scegli Esegui. Ad esempio, per trovare tutti i film con protagonista nel titolo usciti nel 2000 o prima, puoi inserire:(and title:'star' year:{,2000]). Per ulteriori informazioni, consulta Creazione di query composte. Per inviare Lucene o DisMax delle domande, seleziona il parser di interrogazione appropriato.

È possibile specificare opzioni aggiuntive per il parser di query selezionato per configurare l'operatore predefinito e controllare quali operatori possono essere utilizzati in una query. Per ulteriori informazioni, consulta Parametri delle richieste di ricerca.

È possibile copiare e incollare la richiesta URL per inviarla e visualizzare la risposta da un browser Web. Le richieste possono essere inviate tramite HTTP oHTTPS.

Invio di richieste di ricerca da un browser Web

Puoi inviare le richieste di ricerca direttamente al tuo endpoint di ricerca tramite un qualsiasi browser Web. Puoi usare qualsiasi parser di query (semplice, strutturato, lucene o dismax) e specificare una serie di opzioni per limitare la ricerca, richiedere informazioni sui facet, personalizzare la classificazione e controllare quali informazioni vengono restituite nei risultati.

Ad esempio, per cercare nel dominio dei film e ottenere i titoli di tutti i film di Star Wars disponibili, aggiungi la seguente stringa di ricerca al tuo endpoint di ricerca. (2013-01-01 è la API versione e deve essere specificata).

/2013-01-01/search?q=star+wars&return=title

Nota

L'endpoint di ricerca del tuo dominio è mostrato nel pannello di controllo del dominio. È inoltre possibile eseguire una ricerca dalla Console di AWS gestione, visualizzare la richiesta e la risposta non elaborate e copiare la richiesta dal campo Richiesta di ricerca. URL Gli endpoint di ricerca e del servizio documenti di un dominio rimangono invariati per tutta la durata del dominio.

Per impostazione predefinita, Amazon CloudSearch restituisce la risposta inJSON. Puoi anche formattare i risultati della ricerca XML specificando il format parametro,. format=xml (Tieni presente che gli errori possono essere restituiti in uno JSON o nell'altroXML, a seconda dell'origine dell'errore.)

Ricerca nei campi numerici

Puoi utilizzare la sintassi delle query strutturate, q.parser=structured, per cercare i documenti con particolari attributi numerici. Puoi cercare un valore esatto o un intervallo di valori all'interno di qualsiasi campo numerico (double, double-array, int, int-array). Per ricercare un intervallo di valori, specifica i limiti superiore e inferiore, separati da una virgola, e inserisci l'intervallo tra parentesi tonde o parentesi graffe. Usa parentesi quadre ([,]) per includere i limiti e parentesi graffe ({,}) per escluderli. Per esempio:

• year:2000 restituisce i documenti il campo dell'anno contiene il valore 2000.

• year:[2000,} restituisce i documenti il cui campo dell'anno contiene un valore maggiore o uguale a 2000

• year:{,2000] restituisce i documenti il cui campo dell'anno contiene un valore inferiore o uguale a 2000

• year:[2000,2011] restituisce i documenti il cui campo dell'anno contiene valori compresi tra 2000 e 2011 inclusi.

• year:{2000,2011} restituisce i documenti il cui campo dell'anno contiene valori compresi tra 2000 e 2011 esclusi.

Nei campi della data, puoi anche ricercare una specifica data o un intervallo di date, ma devi includere ogni stringa di data tra virgolette singole: release_date:['2000-01-01T00:00:00Z','2011-01-01T00:00:00Z'].

Ad esempio, la seguente query strutturata ricerca "star" nel campo del titolo, trova tutti i film corrispondenti usciti prima del 2000 e restituisce il titolo, l'anno e il punteggio di rilevanza di ciascuno di essi:

Esempio

q=(and title:'star' year:{,2000])&q.parser=structured&return=title,year,_score

La risposta mostra lo stato della richiesta, il numero di documenti corrispondenti e i campi obbligatori per ogni occorrenza.

{
    "status": {
        "rid": "hLPckLsoEQoELQo=",
        "time-ms": 2
    },
    "hits": {
        "found": 15,
        "start": 0,
        "hit": [
            {
                "id": "tt0076759",
                "fields": {
                    "title": "Star Wars",
                    "year": "1977",
                    "_score": "5.7601414"
                }
            },
            .
            .
            .
            {
                "id": "tt0088170",
                "fields": {
                    "title": "Star Trek III: The Search for Spock",
                    "year": "1984",
                    "_score": "4.2371693"
                }
            }
        ]
    }
}

Per ulteriori informazioni sulle query di ricerca strutturate, consultare Ricerca nei tuoi dati con Amazon CloudSearch.

Ordinamento dei risultati di ricerca

Per impostazione predefinita, Amazon CloudSearch ordina i risultati della ricerca in base a una pertinenza _score generata automaticamente. Puoi modificare il modo in cui i risultati vengono ordinati utilizzando il parametro sort (ordinamento) nella tua richiesta di ricerca per specificare il campo o l'espressione da utilizzare per la classificazione. (Un'espressione è un'espressione numerica personalizzata che può essere valutata per ogni documento nel set di documenti corrispondenti. Per informazioni sulla definizione delle espressioni personalizzate, vedereConfigurazione di espressioni.)

Se specifichi un campo di testo con il parametro sort, i risultati vengono ordinati alfabeticamente in base al campo. Ad esempio, per ordinare alfabeticamente per titolo i risultati provenienti dal tuo dominio dei film, aggiungi &sort=title asc alla stringa di query:

2013-01-01/search?q=(and genres:'Sci-Fi' year:{,2000])&q.parser=structured&return=title,year&sort=title asc

Tieni presente che devi specificare in modo esplicito la direzione dell'ordinamento, ossia asc (ascendente) o desc (discendente). Quando esegui l'ordinamento alfabetico, Amazon CloudSearch ordina per codepoint Unicode. Questo significa che i numeri precedono le lettere e le lettere maiuscole precedono quelle minuscole. I numeri vengono ordinati come stringhe, ad esempio 10 viene prima di 2.

Analogamente, puoi specificare un intero campo valori interi con il parametro sort per ordinare i risultati numericamente.

Se si specifica un elenco separato da virgole di campi o espressioni, il primo campo o la prima espressione vengono utilizzati come criterio di ordinamento principale, il secondo come criterio di ordinamento secondario e così via.

Per ulteriori informazioni sulla classificazione dei risultati, consultare Ordinamento dei risultati in Amazon CloudSearch.

Acquisizione delle informazioni sui facet

Un facet è un campo dell'indice che rappresenta una categoria che desideri utilizzare per perfezionare e filtrare i risultati della ricerca. Quando invii richieste di ricerca ad Amazon CloudSearch, puoi richiedere informazioni sui facet per scoprire quanti risultati condividono lo stesso valore in un facet. Puoi visualizzare queste informazioni insieme ai risultati della ricerca e utilizzarle per consentire agli utenti di affinare le loro ricerche in modo interattivo. (tale attività viene spesso indicata come navigazione o ricerca con facet).

Un facet può essere qualsiasi campo datale, letterale o numerico con sfaccettatura abilitata nella configurazione del dominio. Per ogni sfaccettatura, Amazon CloudSearch calcola il numero di accessi che condividono lo stesso valore. Puoi definire dei bucket per calcolare il numero di sfaccettature per particolari sottoinsiemi dei valori delle sfaccettature. Solo i bucket con corrispondenze vengono inclusi nei risultati delle faccette.

Per ottenere i numeri di facet con i tuoi risultati di ricerca

• Usa l'opzione facet.FIELD per specificare un campo per cui desideri calcolare i facet. Per i IMDb filmati di esempio, il faceting dei dati è abilitato per i seguenti campi:genres,,rank, ratingrelease_date, running_time_secs e. year Le opzioni di sfaccettatura vengono specificate come oggetto. JSON Se l'JSONoggetto è vuotofacet.FIELD={}, il conteggio delle sfaccettature viene calcolato per tutti i valori del campo, le sfaccettature vengono ordinate in base al numero di sfaccettature e le prime 10 sfaccettature vengono restituite nei risultati:

  q=star&return=title&facet.genres={}

I facet appaiono sotto le occorrenze nei risultati.

facets": {

    "genres": {
        "buckets": [
            {"value": "Comedy","count": 41},
            .
            .
            .
            {"value": "Sport", "count": 7}
        ]
    }
}

Puoi specificare le opzioni per calcolare i facet per i valori dei campi selezionati, specificare il numero massimo di valori dei facet da includere nei risultati e controllare il modo in cui i facet vengono ordinati.

Per definire i bucket per il calcolo dei numeri di facet per i valori dei campi selezionati, specifica l'opzione buckets. Ad esempio, la seguente richiesta ordina i numeri di facet per il campo dell'anno in base alla decade:

q=star&facet.year={buckets:["[1970,1979]","[1980,1989]","[1990,1999]"]}

Questo vincola il numero di facet ai tre intervalli specificati:

"facets": {
        "year": {
            "buckets": [
                {"value": "[1970,1979]", "count": 3},
                {"value": "[1980,1989]","count": 7},
                {"value": "[1990,1999]","count": 12}
            ]
        }
}

Per ulteriori informazioni sulla definizione delle opzioni dei facet, consultare Come ottenere e utilizzare le informazioni sui facet in Amazon CloudSearch.

Acquisizione delle evidenziazioni di ricerca

Un evidenziazione di ricerca è un estratto di un campo di testo o array di testo che mostra il punto in cui il termine di ricerca appare nel campo.

Per ottenere le informazioni sulle evidenziazioni con i risultati di ricerca

• Usa l'opzione highlight.FIELD per specificare il campo di testo o array di testo per cui desideri ottenere le evidenziazioni. Il campo deve essere evidenziabile nelle opzioni di indicizzazione del tuo dominio. Per i IMDb filmati di esempio l'evidenziazione dei dati è abilitata per i seguenti campi:,, e. actors directors plot title Le opzioni di evidenziazione sono specificate come JSON oggetto. Se l'JSONoggetto è vuotohighlight.FIELD={}, Amazon CloudSearch evidenzia tutte le occorrenze dei termini di ricerca racchiudendoli tra tag di HTML enfasi e gli estratti vengono restituiti come. <em>term</em> HTML

  q=title:'star'&q.parser=structured&return=_no_fields&highlight.title={}

Le informazioni sulle evidenziazioni sono incluse con ogni occorrenza di ricerca.

hits": {
    "found": 29,
    "start": 0,
    "hit": [
        {
            "id": "tt0796366",
            "highlights": {
                "title": "<em>Star</em> Trek"
            }
        },
        .
        .
        .
        {
            "id": "tt2488496",
            "highlights": {
                "title": "<em>Star</em> Wars: Episode VII"
            }
        }
    ]
}

Per ulteriori informazioni sulla definizione delle opzioni di evidenziazione, consultare Evidenziazione dei risultati di ricerca in Amazon CloudSearch.