Migrazione all'API Amazon CloudSearch 2013-01-01

Schemi di analisi: si configurano gli schemi di analisi per specificare opzioni di elaborazione del testo specifiche della lingua per campi e campi. text text-array Amazon CloudSearch ora supporta 33 lingue, oltre a un'opzione per campi multilingue. Per ulteriori informazioni, consulta Configurazione degli schemi di analisi. Per un elenco completo delle lingue supportate, vedi Lingue supportate.

Opzioni di disponibilità: puoi abilitare l'opzione Multi-AZ per espandere un dominio in una seconda zona di disponibilità per garantire la disponibilità in caso di interruzione del servizio. Per ulteriori informazioni, consulta Configurazione delle opzioni di disponibilità.

Opzioni di scalabilità: è possibile impostare il tipo di istanza e il numero di repliche desiderati per aumentare la capacità di caricamento o di ricerca, velocizzare le richieste di ricerca e migliorare la tolleranza agli errori. Per ulteriori informazioni, consulta Configurazione delle opzioni di scalabilità in Amazon CloudSearch.

Suggestori: è possibile configurare i suggeritori per implementare la funzionalità di completamento automatico. Per ulteriori informazioni, consulta Configurazione dei suggestori per Amazon CloudSearch.

Schema di analisi: si configura l'elaborazione del testo specifica della lingua per campo specificando uno schema di analisi per ogni campo. text text-array Per ulteriori informazioni, consulta Configurazione degli schemi di analisi.

Tipi di campo: Amazon CloudSearch ora supporta 11 tipi di campo:

Evidenzia: quando abiliti l'opzione di evidenziazione per un campo, puoi recuperare degli estratti che mostrano dove si trovano i termini di ricerca all'interno di quel campo. Per ulteriori informazioni, consulta Evidenziazione dei risultati di ricerca su Amazon CloudSearch.

Origine: puoi specificare un'origine per un campo in modo che i dati vengano copiati da un campo all'altro. In questo modo potrai utilizzare gli stessi dati di origine in modi diversi configurando opzioni diverse per i campi.

Per impostazione predefinita, quando si aggiunge un campo sono abilitate tutte le opzioni valide per quel tipo di campo. Se da un lato questo è utile per lo sviluppo e i test, disabilitare le opzioni non necessarie può ridurre la dimensione dell'indice e migliorare le prestazioni.

È necessario utilizzare campi di tipo array separati per i campi multivalore.

Solo i campi a valore singolo possono essere abilitati per l'ordinamento.

Solo i campi text e text-array possono essere evidenziabili.

Tutti i campi possono essere abilitati per i facet, ad eccezione di text e text-array.

Per i campi letterali ora viene fatta distinzione tra maiuscole e minuscole.

Non è più necessario archiviare i valori a virgola mobile come numeri interi: utilizza un campo double.

Puoi archiviare le posizioni utilizzando il nuovo tipo di campo latlon. Per ulteriori informazioni, consulta location-based searching and sorting.

Un campo int è un valore intero con firma a 64 bit.

Anziché configurare un campo di ricerca predefinito, è possibile specificare i campi per la ricerca con il parametro q.options nelle richieste di ricerca. Il parametro q.options inoltre consente di specificare la rilevanza per ogni campo.

Quando si ordinano e si configurano le espressioni, si fa riferimento al punteggio di rilevanza predefinito con il nome _score. A causa delle modifiche all'algoritmo di pertinenza, i punteggi calcolati saranno diversi da quelli dell'API 2011-02-01. Per ulteriori informazioni, consulta Configurazione di espressioni.

Le espressioni ora supportano le funzioni logn, atan2 e haversin, nonché le variabili _score (punteggio di rilevanza testo) e _time (epoca). Se archivi posizioni nei campi latlon, puoi fare riferimento ai valori di latitudine e longitudine come a FIELD.latitude e FIELD.longitude. È inoltre possibile fare riferimento a entrambi i campi int e double nelle espressioni. Le funzioni seguenti non sono più supportate: cs.text_relevance, erf, lgamma, rand e time. Per ulteriori informazioni, consulta Configurazione di espressioni.

DefineAnalysisScheme

DefineExpression

DefineSuggester

DeleteAnalysisScheme

DeleteExpression

DeleteSuggester

DexcribeAnalysisSchemes

DescribeAvailabilityOptions

DescribeExpressions

DescribeScalingParameters

DescribeSuggesters

ListDomainNames

UpdateAvailabilityOptions

UpdateScalingParameters

DefineRankExpression

DescribeRankExpression

DeleteRankExpression

DescribeDefaultSearchField

DescribeStemmingOptions

DescribeStopwordOptions

DescribeSynonymOptions

UpdateDefaultSearchField

UpdateStemmingOptions

UpdateStopwordOptions

UpdateSynonymOptions

Omettere gli attributi version e lang dai propri batch di documenti.

Accertarsi che tutti i campi dei documenti corrispondano ai campi dell'indice configurati per il proprio dominio. I campi non riconosciuti non vengono più ignorati, generano un errore.

Pubblica i batch di documenti nell'endpoint doc del tuo dominio 2013-01-01. Tieni presente che devi specificare la versione dell'API 2013-01-01. Ad esempio, la seguente richiesta pubblica il batch contenuto in data1.json per l'endpoint doc-movies-123456789012.us-east-1.cloudsearch.amazonaws.com.

curl -X POST --upload-file data1.json doc-movies-123456789012.us-east-1.
cloudsearch.amazonaws.com/2013-01-01/documents/batch --header "Content-Type:
application/json"

Usa la versione dell'API 2013-01-01 in tutte le richieste.

Utilizza il parametro q per specificare i criteri di ricerca per tutte le richieste. Il parametro bq non è più supportato. Per utilizzare la sintassi di ricerca strutturata (booleana), specifica q.parser=structured nella richiesta.

I parametri non possono essere ripetuti in una richiesta di ricerca.

Il carattere jolly (*) è supportato solo quando si usa il parser di query semplice. Utilizza l'operatore prefix per eseguire il confronto del prefisso con il parser di query strutturate. Ad esempio q=(prefix 'oce')&q.parser=structured.

Utilizza il nome di campo _id per fare riferimento al campo degli ID dei documenti in una richiesta di ricerca. Il nome di campo docid non è più supportato.

Utilizza l'operatore range per la ricerca in un campo di un valore interno all'intervallo specificato. L'operatore filter non è più supportato.

Utilizza la nuova sintassi degli intervalli per cercare intervalli di valori, tra cui date e ubicazioni archiviate nei campi latlon. La notazione del doppio punto (..) non è più supportata. Separa i limiti superiore e inferiore con una virgola (,) e racchiudi l'intervallo tra parentesi graffe. Una parentesi quadra ([,]) indica che il limite è incluso, una parentesi graffa ({,}) esclude il limite. Ad esempio, year:2008..2011 è ora espresso come year:[2008,2011]. Un intervallo aperto, come year:..2011 è ora espresso come year:{,2011].

Utilizza l'operatore term per la ricerca in un campo di un valore specifico. L'operatore field non è più supportato.

Utilizza il parametro q.options per specificare le rilevanze di campo. La funzione cs.text_relevance non è più supportata. Ad esempio q.options={fields:['title^2','plot^0.5']}.

Utilizza il parametro fq per filtrare i risultati senza modificare l'ordine di priorità dei documenti corrispondenti.

Utilizza un punto (.) piuttosto che un trattino (-) come separatore nei parametri di prefisso: expr.NAME, facet.FIELD, highlight.FIELD.

Utilizza il parametro facet.FIELD per specificare tutte le opzioni facet. I parametri facet-FIELD-top-N, facet-FIELD-sort e facet-FIELD-constraints non sono più supportati.

Utilizza il parametro sort per specificare i campi o le espressioni che desideri utilizzare per l'ordinamento. È necessario specificare in modo esplicito il tipo di ordinamento nel parametro. Ad esempio sort=rank asc, date desc. Il parametro rank non è più supportato.

Utilizza expr.NAME per definire un'espressione in una richiesta di ricerca. Il parametro rank-RANKNAME non è più supportato.

Utilizza format=xml per ottenere i risultati in formato XML. Il parametro result-type non è più supportato.

Potenziamento dei termini: utilizza l'boostopzione in una query strutturata per aumentare l'importanza di una parte della query rispetto alle altre parti. Per ulteriori informazioni, consulta Creazione di query composte.

Ricerca per frasi sciatta: utilizza l'nearoperatore in una query strutturata per cercare più termini in un text-array campo text o e trovare documenti che contengono i termini entro la distanza specificata l'uno dall'altro. Puoi eseguire una ricerca di frasi simili anche con il parser di query semplice, aggiungendo l'operatore ~ e un valore al periodo. Per ulteriori informazioni, consulta Ricerca di frasi.

Ricerca fuzzy: utilizza l'~operatore per eseguire ricerche fuzzy con il semplice parser di query. Aggiungere l'operatore ~ e un valore a un termine per indicare in che misura i termini possono differire ed essere considerati comunque una corrispondenza. Per ulteriori informazioni, consulta Ricerca di singoli termini.

Evidenziazione: utilizza il parametro per evidenziare le corrispondenze in un campo particolare. highlight.FIELD Per ulteriori informazioni, consulta Evidenziazione dei risultati di ricerca su Amazon CloudSearch.

Completamento automatico: configura un suggeritore e invia le richieste alla suggester risorsa per ottenere un elenco dei completamenti delle query e dei documenti in cui sono stati trovati. Per ulteriori informazioni, consulta Ottenere suggerimenti per il completamento automatico in Amazon CloudSearch.

Risultati di ricerca parziali: utilizza il partial=true parametro per recuperare risultati parziali quando una o più partizioni di indice non sono disponibili. Per impostazione predefinita, Amazon restituisce risultati CloudSearch solo se è possibile interrogare ogni partizione.

Deep paging: usa il cursor parametro per impaginare i risultati quando hai un set di risultati di grandi dimensioni. Per ulteriori informazioni, consulta Paginate the results.

Confronto di tutti i documenti: l'operatore di query strutturata matchall consente di recuperare tutti i documenti nell'indice.

Nuovi parser di interrogazione: utilizzate il q.parser parametro per selezionare Lucene o i DisMax parser anziché il parser semplice o strutturato oppure. q.parser=lucene q.parser=dismax

Le stringhe non vengono più trasformate in token in corrispondenza delle maiuscole e i periodi che non sono seguiti da uno spazio vengono considerati parte del termine. Per ulteriori informazioni, consulta Elaborazione del testo in Amazon CloudSearch.

Per i campi letterali ora viene fatta distinzione tra maiuscole e minuscole.

Le risposte delle ricerche non includono più la posizione in classifica, l'espressione corrispondente o il tempo CPU. Le uniche informazioni sullo stato restituite sono l'ID di risorsa (rid) e il tempo di elaborazione (time-ms).

Quando si ottengono informazioni sui facet per un campo int, i valori min e max non vengono più restituiti.

cursor.FIELD

expr.NAME

facet.FIELD

format

fq

highlight.FIELD

partial

pretty

q.options

q.parser

return

sort

boost

matchall

near

phrase

prefix

range

term

bq

facet-FIELD-top-N

facet-FIELD-sort

facet-FIELD-constraints

rank

rank-RANKNAME

return-fields

result-type

t-FIELD

field

filtro

-

|

+

*