SimpleField interface
Rappresenta un campo in una definizione di indice, che descrive il nome, il tipo di dati e il comportamento di ricerca di un campo.
Proprietà
analyzer |
Nome dell'analizzatore del linguaggio da usare per il campo. Questa opzione può essere usata solo con campi ricercabili e non può essere impostata con searchAnalyzer o indexAnalyzer. Una volta scelto, l'analizzatore non può essere cambiato per il campo. NotoAnalyzerNames è un enumerazione contenente nomi di analizzatori predefiniti. |
facetable | Valore che indica se abilitare il campo a cui fare riferimento nelle query facet. In genere usato in una presentazione dei risultati della ricerca che includono il numero di hit per categoria (ad esempio, cercare fotocamere digitali e vedere le hit per marchio, da megalie, per prezzo e così via). I campi di tipo Edm.GeographyPoint o Collection(Edm.GeographyPoint) non possono essere visibili. Il valore predefinito è false per tutti gli altri campi semplici. |
filterable | Valore che indica se abilitare il campo a cui fare riferimento nelle query $filter. Il filtro è diverso dal modo in cui vengono gestite le stringhe. I campi di tipo Edm.String o Collection(Edm.String) che sono filtrabili non subiscono interruzioni di parole, quindi i confronti sono solo per corrispondenze esatte. Ad esempio, se si imposta un campo f su "giorno sole", $filter=f eq 'sunny' non troverà corrispondenze, ma $filter=f eq 'sunny day' will. L'impostazione predefinita è false. |
hidden | Valore che indica se il campo può essere restituito in un risultato di ricerca. È possibile abilitare questa opzione se si vuole usare un campo (ad esempio, margine) come filtro, ordinamento o meccanismo di assegnazione dei punteggi, ma non si vuole che il campo sia visibile all'utente finale. Questa proprietà deve essere false per i campi chiave. Questa proprietà può essere modificata nei campi esistenti. La disabilitazione di questa proprietà non causa alcun aumento dei requisiti di archiviazione dell'indice. L'impostazione predefinita è false. |
index |
Nome dell'analizzatore usato in fase di indicizzazione per il campo. Questa opzione può essere usata solo con campi ricercabili. Deve essere impostato insieme a searchAnalyzer e non può essere impostato insieme all'opzione analizzatore. Una volta scelto, l'analizzatore non può essere cambiato per il campo. NotoAnalyzerNames è un enumerazione contenente nomi di analizzatori predefiniti. |
key | Valore che indica se il campo identifica in modo univoco i documenti nell'indice. È necessario scegliere esattamente un campo di primo livello in ogni indice come campo chiave e deve essere di tipo Edm.String. I campi chiave possono essere usati per cercare i documenti direttamente ed aggiornare o eliminare documenti specifici. L'impostazione predefinita è false. |
name | Nome del campo, che deve essere univoco all'interno dell'insieme campi del campo indice o padre. |
searchable | Valore che indica se il campo è ricercabile in full-text. Ciò significa che verrà sottoposto ad analisi, ad esempio la suddivisione in parole durante l'indicizzazione. Se si imposta un campo ricercabile su un valore come "sunny day", questo viene suddiviso internamente nei singoli token "sunny" e "day". È così possibile eseguire ricerche full-text di questi termini. Questa proprietà deve essere false per i campi semplici di altri tipi di dati non stringa. Nota: i campi ricercabili usano spazio aggiuntivo nell'indice poiché Ricerca cognitiva di Azure archivierà una versione tokenizzata aggiuntiva del valore del campo per le ricerche full-text. Impostazione predefinita su false per i campi semplici. |
search |
Nome dell'analizzatore usato in fase di ricerca per il campo. Questa opzione può essere usata solo con campi ricercabili. Deve essere impostato insieme a indexAnalyzer e non può essere impostato insieme all'opzione analizzatore. Questo analizzatore può essere aggiornato per un campo esistente. NotoAnalyzerNames è un enumerazione contenente nomi di analizzatori predefiniti. |
sortable | Valore che indica se abilitare il campo a cui fare riferimento nelle espressioni di $orderby. Per impostazione predefinita, Ricerca cognitiva di Azure ordina i risultati per punteggio, ma in molte esperienze gli utenti vogliono ordinare in base ai campi nei documenti. Un campo semplice può essere ordinabile solo se è a valore singolo (ha un singolo valore nell'ambito del documento padre). I campi di raccolta semplici non possono essere ordinabili, poiché sono multivalore. I campi secondari semplici delle raccolte complesse sono anche multivalore e pertanto non possono essere ordinabili. Questo è vero se si tratta di un campo padre immediato o di un campo predecessore, ovvero la raccolta complessa. Il valore predefinito per ordinabile è false. |
synonym |
Elenco dei nomi delle mappe sinonimi da associare a questo campo. Questa opzione può essere usata solo con campi ricercabili. Attualmente è supportata solo una mappa sinonimo per campo. L'assegnazione di un mapping sinonimo a un campo garantisce che i termini di query destinati al campo vengano espansi in fase di query usando le regole nella mappa sinonimia. Questo attributo può essere modificato nei campi esistenti. |
type | Tipo di dati del campo. I valori possibili includono: 'Edm.String', 'Edm.Int32', 'Edm.Int64', 'Edm.Double', 'Edm.Boolean', 'Edm.DateTimeOffset', 'Edm.GeographyPoint', 'Collection(Edm.String)', 'Collection(Edm.Int32)', 'Collection(Edm.Int64)', 'Collection(Edm.Double)', 'Collection(Edm.Boolean)', 'Collection(Edm.DateTimeOffset)', 'Collection(Edm.GeographyPoint)', 'Collection(Edm.Single)' |
vector |
Dimensione del campo vettore. |
vector |
Nome della configurazione dell'algoritmo di ricerca vettore che specifica l'algoritmo e i parametri facoltativi per la ricerca del campo vettore. |
Dettagli proprietà
analyzerName
Nome dell'analizzatore del linguaggio da usare per il campo. Questa opzione può essere usata solo con campi ricercabili e non può essere impostata con searchAnalyzer o indexAnalyzer. Una volta scelto, l'analizzatore non può essere cambiato per il campo. NotoAnalyzerNames è un enumerazione contenente nomi di analizzatori predefiniti.
analyzerName?: string
Valore della proprietà
string
facetable
Valore che indica se abilitare il campo a cui fare riferimento nelle query facet. In genere usato in una presentazione dei risultati della ricerca che includono il numero di hit per categoria (ad esempio, cercare fotocamere digitali e vedere le hit per marchio, da megalie, per prezzo e così via). I campi di tipo Edm.GeographyPoint o Collection(Edm.GeographyPoint) non possono essere visibili. Il valore predefinito è false per tutti gli altri campi semplici.
facetable?: boolean
Valore della proprietà
boolean
filterable
Valore che indica se abilitare il campo a cui fare riferimento nelle query $filter. Il filtro è diverso dal modo in cui vengono gestite le stringhe. I campi di tipo Edm.String o Collection(Edm.String) che sono filtrabili non subiscono interruzioni di parole, quindi i confronti sono solo per corrispondenze esatte. Ad esempio, se si imposta un campo f su "giorno sole", $filter=f eq 'sunny' non troverà corrispondenze, ma $filter=f eq 'sunny day' will. L'impostazione predefinita è false.
filterable?: boolean
Valore della proprietà
boolean
hidden
Valore che indica se il campo può essere restituito in un risultato di ricerca. È possibile abilitare questa opzione se si vuole usare un campo (ad esempio, margine) come filtro, ordinamento o meccanismo di assegnazione dei punteggi, ma non si vuole che il campo sia visibile all'utente finale. Questa proprietà deve essere false per i campi chiave. Questa proprietà può essere modificata nei campi esistenti. La disabilitazione di questa proprietà non causa alcun aumento dei requisiti di archiviazione dell'indice. L'impostazione predefinita è false.
hidden?: boolean
Valore della proprietà
boolean
indexAnalyzerName
Nome dell'analizzatore usato in fase di indicizzazione per il campo. Questa opzione può essere usata solo con campi ricercabili. Deve essere impostato insieme a searchAnalyzer e non può essere impostato insieme all'opzione analizzatore. Una volta scelto, l'analizzatore non può essere cambiato per il campo. NotoAnalyzerNames è un enumerazione contenente nomi di analizzatori predefiniti.
indexAnalyzerName?: string
Valore della proprietà
string
key
Valore che indica se il campo identifica in modo univoco i documenti nell'indice. È necessario scegliere esattamente un campo di primo livello in ogni indice come campo chiave e deve essere di tipo Edm.String. I campi chiave possono essere usati per cercare i documenti direttamente ed aggiornare o eliminare documenti specifici. L'impostazione predefinita è false.
key?: boolean
Valore della proprietà
boolean
name
Nome del campo, che deve essere univoco all'interno dell'insieme campi del campo indice o padre.
name: string
Valore della proprietà
string
searchable
Valore che indica se il campo è ricercabile in full-text. Ciò significa che verrà sottoposto ad analisi, ad esempio la suddivisione in parole durante l'indicizzazione. Se si imposta un campo ricercabile su un valore come "sunny day", questo viene suddiviso internamente nei singoli token "sunny" e "day". È così possibile eseguire ricerche full-text di questi termini. Questa proprietà deve essere false per i campi semplici di altri tipi di dati non stringa. Nota: i campi ricercabili usano spazio aggiuntivo nell'indice poiché Ricerca cognitiva di Azure archivierà una versione tokenizzata aggiuntiva del valore del campo per le ricerche full-text. Impostazione predefinita su false per i campi semplici.
searchable?: boolean
Valore della proprietà
boolean
searchAnalyzerName
Nome dell'analizzatore usato in fase di ricerca per il campo. Questa opzione può essere usata solo con campi ricercabili. Deve essere impostato insieme a indexAnalyzer e non può essere impostato insieme all'opzione analizzatore. Questo analizzatore può essere aggiornato per un campo esistente. NotoAnalyzerNames è un enumerazione contenente nomi di analizzatori predefiniti.
searchAnalyzerName?: string
Valore della proprietà
string
sortable
Valore che indica se abilitare il campo a cui fare riferimento nelle espressioni di $orderby. Per impostazione predefinita, Ricerca cognitiva di Azure ordina i risultati per punteggio, ma in molte esperienze gli utenti vogliono ordinare in base ai campi nei documenti. Un campo semplice può essere ordinabile solo se è a valore singolo (ha un singolo valore nell'ambito del documento padre). I campi di raccolta semplici non possono essere ordinabili, poiché sono multivalore. I campi secondari semplici delle raccolte complesse sono anche multivalore e pertanto non possono essere ordinabili. Questo è vero se si tratta di un campo padre immediato o di un campo predecessore, ovvero la raccolta complessa. Il valore predefinito per ordinabile è false.
sortable?: boolean
Valore della proprietà
boolean
synonymMapNames
Elenco dei nomi delle mappe sinonimi da associare a questo campo. Questa opzione può essere usata solo con campi ricercabili. Attualmente è supportata solo una mappa sinonimo per campo. L'assegnazione di un mapping sinonimo a un campo garantisce che i termini di query destinati al campo vengano espansi in fase di query usando le regole nella mappa sinonimia. Questo attributo può essere modificato nei campi esistenti.
synonymMapNames?: string[]
Valore della proprietà
string[]
type
Tipo di dati del campo. I valori possibili includono: 'Edm.String', 'Edm.Int32', 'Edm.Int64', 'Edm.Double', 'Edm.Boolean', 'Edm.DateTimeOffset', 'Edm.GeographyPoint', 'Collection(Edm.String)', 'Collection(Edm.Int32)', 'Collection(Edm.Int64)', 'Collection(Edm.Double)', 'Collection(Edm.Boolean)', 'Collection(Edm.DateTimeOffset)', 'Collection(Edm.GeographyPoint)', 'Collection(Edm.Single)'
type: SearchFieldDataType
Valore della proprietà
vectorSearchDimensions
Dimensione del campo vettore.
vectorSearchDimensions?: number
Valore della proprietà
number
vectorSearchProfileName
Nome della configurazione dell'algoritmo di ricerca vettore che specifica l'algoritmo e i parametri facoltativi per la ricerca del campo vettore.
vectorSearchProfileName?: string
Valore della proprietà
string