Créer et enregistrer un schéma

Un schéma Google Cloud Search est une structure JSON qui définit les objets, les propriétés et les options à utiliser pour indexer et interroger vos données. Le connecteur de contenu lit les données de votre dépôt et, selon le schéma enregistré, les structure et les indexe.

Vous pouvez créer un schéma en fournissant un objet de schéma JSON à l'API, puis en l'enregistrant. Vous devez enregistrer un objet de schéma pour chacun de vos dépôts avant de pouvoir indexer vos données.

Remarque : Vous n'avez pas besoin de créer un schéma si votre dépôt de données ne contient que des données non structurées. Par exemple, si vous disposez d'un système de partage de fichiers de base sans types et structures de fichiers prédéterminés, vous n'aurez généralement pas besoin d'un schéma. Vous pouvez également créer un objet de schéma à l'aide du SDK au lieu de fournir un objet JSON à l'API.

Ce document traite des principes de base de la création de schémas. Pour savoir comment ajuster votre schéma afin d'améliorer l'expérience de recherche, consultez Améliorer la qualité de la recherche.

Créer un schéma

Voici la liste des étapes utilisées pour créer votre schéma Cloud Search:

1. Identifier le comportement attendu des utilisateurs
2. Initialiser une source de données
3. Créer un schéma
4. Exemple de schéma complet
5. Enregistrer votre schéma
6. Indexer vos données
7. Tester votre schéma
8. Ajuster votre schéma

Remarque:Ce document utilise des extraits d'un schéma pour une base de données de films hypothétique. Pour obtenir le schéma complet, consultez schema.json.

Identifier le comportement attendu de l'utilisateur

Anticiper les types de requêtes que vos utilisateurs effectuent vous aide à orienter votre stratégie de création de schéma.

Par exemple, lors de l'envoi de requêtes à une base de données cinématographique, vous pouvez anticiper une requête du type "Montre-moi tous les films avec Robert Redford". Votre schéma doit donc accepter les résultats des requêtes basés sur "&tous les films avec un acteur spécifique".

Pour définir votre schéma afin de refléter les modèles de comportement de vos utilisateurs, effectuez les tâches suivantes:

1. Évaluez un ensemble varié de requêtes souhaitées provenant de différents utilisateurs.
2. Identifier les objets pouvant être utilisés dans les requêtes Les objets sont des ensembles logiques de données associées, comme un film dans une base de données de films.
3. Identifiez les propriétés et les valeurs qui composent l'objet et qui pourraient être utilisées dans les requêtes. Les propriétés correspondent aux attributs indexables de l'objet. Elles peuvent inclure des valeurs primitives ou d'autres objets. Par exemple, un objet "movie" peut avoir des propriétés primitives, telles que le titre et la date de sortie du film. L'objet "movie" peut également contenir d'autres objets, tels que des membres "cast", qui ont leurs propres propriétés, telles que leur nom ou leur rôle.
4. Identifier des exemples de valeurs valides pour les propriétés Les valeurs correspondent aux données réellement indexées pour une propriété. Par exemple, le titre d'un film de votre base de données peut être "L'Aventurier de l'arche perdue".
5. Déterminez les options de tri et de classement souhaitées pour vos utilisateurs. Par exemple, lors de l'interrogation de films, les utilisateurs peuvent vouloir trier les résultats par ordre chronologique et les classer par ordre d'audience, sans avoir à les trier par titre.
6. (Facultatif) Déterminez si l'une de vos propriétés représente un contexte plus spécifique dans lequel les recherches peuvent être exécutées, par exemple le poste ou le poste de l'utilisateur, afin que des suggestions de saisie semi-automatique puissent être fournies en fonction du contexte. Par exemple, pour les personnes recherchant une base de données de films, un utilisateur peut ne s'intéresser qu'à un certain genre de films. Les utilisateurs définissent le genre de recherche qu'ils souhaitent voir apparaître, éventuellement dans leur profil. Ensuite, lorsqu'un utilisateur commence à saisir une requête concernant des films, seuls les films du genre souhaité (par exemple, "films d'action") sont suggérés dans les suggestions de saisie semi-automatique.
7. Dressez la liste de ces objets, propriétés et exemples de valeurs qui peuvent être utilisés dans les recherches. (Pour en savoir plus sur l'utilisation de cette liste, consultez la section Définir les options d'opérateur.)

Initialiser votre source de données

Une source de données représente les données d'un dépôt qui ont été indexées et stockées dans Google Cloud. Pour obtenir des instructions sur l'initialisation d'une source de données, consultez la page Gérer des sources de données tierces.

Les résultats de recherche d'un utilisateur sont renvoyés par la source de données. Lorsqu'un utilisateur clique sur un résultat de recherche, Cloud Search le redirige vers l'élément réel à l'aide de l'URL fournie dans la requête d'indexation.

Définir vos objets

L'unité de données fondamentale dans un schéma est l'objet, également appelé objet de schéma, qui est une structure logique de données. Dans une base de données de films, une structure logique de données est "film". Un autre objet peut être "personne" pour représenter les acteurs et l'équipe du film.

Chaque objet d'un schéma possède une série de propriétés ou d'attributs décrivant l'objet, tels que le titre et la durée d'un film, ou le nom et la date de naissance d'une personne. Les propriétés d'un objet peuvent inclure des valeurs primitives ou d'autres objets.

La Figure 1 montre les objets "movie" (film) et "person" (personne), ainsi que les propriétés associées.

Figure 1 Exemple de schéma montrant deux objets et un sous-objet.

Un schéma Cloud Search est essentiellement une liste d'instructions de définition d'objet définies dans le tag objectDefinitions. L'extrait de schéma suivant montre les instructions objectDefinitions pour les objets de schéma "movie" et "person".

{
  "objectDefinitions": [
    {
      "name": "movie",
      ...
    },
    {
      "name": "person",
      ...
    }
  ]
}

Lorsque vous définissez un objet de schéma, vous fournissez un name qui doit être unique parmi tous les autres objets du schéma. Vous utiliserez généralement une valeur name décrivant l'objet, telle que movie pour un objet de film. Le service de schéma utilise le champ name comme identifiant de clé pour les objets indexables. Pour en savoir plus sur le champ name, consultez la définition de l'objet.

Remarque : Un schéma Cloud Search comporte en fait deux sections de premier niveau : objectDefinitions et operationIds. Lorsque votre schéma est utilisé et qu'il y a des opérations de longue durée en attente pour le schéma, les operationIds de ces opérations sont renvoyées lorsque vous demandez le schéma enregistré. Vous ne pouvez pas définir operationIds et vous pouvez ignorer cette partie du schéma.

Définir les propriétés des objets

Comme indiqué dans la référence pour ObjectDefinition, le nom d'objet est suivi d'un ensemble de options et d'une liste de propertyDefinitions. L'élément options peut également comporter les éléments freshnessOptions et displayOptions. Les freshnessOptions permettent d'ajuster le classement des résultats de recherche en fonction de la fraîcheur d'un élément. Le displayOptions permet de définir si des étiquettes et des propriétés spécifiques sont affichées dans les résultats de recherche pour un objet.

Remarque:Pour en savoir plus sur le réglage de freshnessOptions afin d'améliorer l'expérience de recherche, consultez Influencer la fraîcheur dans Améliorer la qualité de la recherche.

La section propertyDefinitions vous permet de définir les propriétés d'un objet, telles que le titre du film et la date de sortie.

L'extrait de code suivant montre l'objet movie avec deux propriétés: movieTitle et releaseDate.

{
  "objectDefinitions": [
    {
      "name": "movie",
      "propertyDefinitions": [
        {
          "name": "movieTitle",
          "isReturnable": true,
          "isWildcardSearchable": true,
          "textPropertyOptions": {
            "retrievalImportance": { "importance": "HIGHEST" },
            "operatorOptions": {
              "operatorName": "title"
            }
          },
          "displayOptions": {
            "displayLabel": "Title"
          }
        },
        {
          "name": "releaseDate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "released",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          },
          "displayOptions": {
            "displayLabel": "Release date"
          }
      ...
      ]
    }
  ]
}

Remarque : Lorsqu'ils sont définis dans le même objet, les noms de propriété qui ne diffèrent que dans le cas présent, tels que movieTitle et movietitle, sont considérés comme identiques et génèrent une erreur.

La propriété PropertyDefinition comprend les éléments suivants:

• Une chaîne name.
• Une liste d'options indépendantes du type, telles que isReturnable dans l'extrait précédent.
• Un type et ses options spécifiques au type associées, telles que textPropertyOptions et retrievalImportance dans l'extrait précédent.
• Un objet operatorOptions décrivant comment la propriété est utilisée en tant qu'opérateur de recherche.
• Un ou plusieurs displayOptions, tels que displayLabel dans l'extrait précédent.

La propriété name d'une propriété doit être unique dans l'objet conteneur, mais le même nom peut être utilisé dans d'autres objets et sous-objets. Dans la figure 1, le titre et la date de sortie du film ont été définis deux fois : une fois dans l'objet movie et une autre fois dans le sous-objet filmography de l'objet person. Ce schéma réutilise le champ movieTitle de sorte qu'il accepte deux types de comportements de recherche:

• Afficher les résultats de films lorsque les utilisateurs recherchent le titre d'un film.
• Afficher les résultats de personnes lorsque les utilisateurs recherchent le titre d'un film dans lequel un acteur a joué.

De même, le schéma réutilise le champ releaseDate, car il a la même signification pour les deux champs movieTitle.

Lorsque vous développez votre propre schéma, réfléchissez à la manière dont votre dépôt peut contenir des champs associés contenant des données que vous souhaitez déclarer plusieurs fois dans votre schéma.

Remarque:Si une requête d'indexation tente d'indexer un élément avec un champ ou une propriété non enregistrés, comme date au lieu de releaseDate, le système supprime le champ. Si la requête d'indexation fournit un type de données incorrect pour une propriété, par exemple un entier pour le champ de durée (qui attend du texte afin de traiter les abréviations d'unités), le système rejette la requête entière.

Ajouter des options indépendantes du type

La section PropertyDefinition liste les options de fonctionnalité de recherche générale communes à toutes les propriétés, quel que soit le type de données.

• isReturnable : indique si la propriété identifie les données à renvoyer dans les résultats de recherche via l'API Query. Tous les exemples de propriétés de film peuvent être renvoyés. Les propriétés qui ne peuvent pas être renvoyées peuvent être utilisées pour rechercher ou classer des résultats sans être renvoyées à l'utilisateur.
• isRepeatable : indique si plusieurs valeurs sont autorisées pour la propriété. Par exemple, un film n'a qu'une seule date de sortie, mais peut avoir plusieurs acteurs.
• isSortable : indique que la propriété peut être utilisée pour le tri. Cela ne peut pas être vrai pour les propriétés reproductibles. Par exemple, les films peuvent être triés par date de sortie ou par audience.
• isFacetable : indique que la propriété peut être utilisée pour générer des attributs. Un attribut permet d'affiner les résultats de recherche. L'utilisateur voit les résultats initiaux, puis ajoute des critères, ou attributs, pour les affiner. Cette option ne peut pas être vraie pour les propriétés dont le type est "object" et isReturnable doit être défini sur "true" pour la définir. Enfin, cette option n'est compatible qu'avec les propriétés énumération, booléennes et textuelles. Par exemple, dans notre exemple de schéma, nous pouvons rendre genre, actorName, userRating et mpaaRating facetable afin de pouvoir les utiliser pour affiner les résultats de recherche de manière interactive.
• isWildcardSearchable indique que les utilisateurs peuvent effectuer une recherche avec caractères génériques pour cette propriété. Cette option n'est disponible que pour les propriétés textuelles. Le fonctionnement de la recherche avec caractères génériques dans le champ de texte dépend de la valeur définie dans le champ exactMatchWithOperator. Si exactMatchWithOperator est défini sur true, la valeur de texte est tokenisée sous la forme d'une valeur atomique, et une recherche de caractère générique est effectuée. Par exemple, si la valeur textuelle est science-fiction, une requête générique science-* lui correspond. Si exactMatchWithOperator est défini sur false, la valeur de texte est tokenisée, et une recherche avec caractères génériques est effectuée sur chaque jeton. Par exemple, si la valeur textuelle est "science-fiction", le caractère générique sci* ou fi* correspond à l'élément, mais science-* ne correspond pas à l'élément.

Ces paramètres de fonctionnalité de recherche générale sont tous des valeurs booléennes. Ils ont tous une valeur par défaut de false et doivent être définis sur true pour pouvoir être utilisés.

Le tableau suivant présente les paramètres booléens définis sur true pour toutes les propriétés de l'objet movie:

Propriété	isReturnable	isRepeatable	isSortable	isFacetable	isWildcardSearchable
movieTitle	true				true
releaseDate	true		true
genre	true	true		true
duration	true
actorName	true	true		true	true
userRating	true		true
mpaaRating	true			true

genre et actorName ont tous deux été définis isRepeatable sur true, car un film peut appartenir à plusieurs genres et comporter généralement plusieurs acteurs. Une propriété ne peut pas être triée si elle est reproductible ou contenue dans un sous-objet reproductible.

Définir le type

La section de référence PropertyDefinition répertorie plusieurs xxPropertyOptions, où xx est un type spécifique, tel que boolean. Pour définir le type de données de la propriété, vous devez définir l'objet de type de données approprié. Définir un objet de type de données pour une propriété établit le type de données de cette propriété. Par exemple, la définition de textPropertyOptions pour la propriété movieTitle indique que le titre du film est de type texte. L'extrait de code suivant montre la propriété movieTitle avec textPropertyOptions définissant le type de données.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    ...
  },
  ...
},

Remarque : Si vous comprenez l'ensemble des valeurs possibles pour une propriété, utilisez une énumération (enumPropertyOptions) au lieu d'un type de chaîne. Si l'énumération change dans les futures versions, utilisez des introspections pour vérifier le schéma et le mettre à jour si nécessaire.

Une propriété ne peut être associée qu'à un seul type de données. Par exemple, dans notre schéma de film, releaseDate ne peut être qu'une date (par exemple, 2016-01-13) ou une chaîne (par exemple, January 13, 2016), mais pas les deux.

Voici les objets de type de données utilisés pour spécifier les types de données des propriétés dans l'exemple de schéma de film:

Propriété	Objet de type de données
movieTitle	textPropertyOptions
releaseDate	datePropertyOptions
genre	enumPropertyOptions
duration	textPropertyOptions
actorName	textPropertyOptions
userRating	integerPropertyOptions
mpaaRating	textPropertyOptions

Le type de données que vous choisissez pour la propriété dépend des cas d'utilisation attendus. Dans l'imaginaire scénario de ce schéma de film, les utilisateurs doivent vouloir trier les résultats par ordre chronologique. releaseDate est donc un objet de date. Si, par exemple, il était prévu de comparer les versions de décembre entre les années et les versions de janvier, un format de chaîne peut être utile.

Configurer les options spécifiques au type

La section de référence PropertyDefinition renvoie aux options associées à chaque type. La plupart des options spécifiques au type sont facultatives, à l'exception de la liste de possibleValues dans enumPropertyOptions. De plus, l'option orderedRanking vous permet de classer les valeurs les unes par rapport aux autres. L'extrait de code suivant montre la propriété movieTitle avec textPropertyOptions définissant le type de données et avec l'option spécifique au type retrievalImportance.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    ...
  },
  ...
}

Voici les options supplémentaires spécifiques au type utilisées dans l'exemple de schéma:

Propriété	Type	Options spécifiques au type
movieTitle	textPropertyOptions	retrievalImportance
releaseDate	datePropertyOptions
genre	enumPropertyOptions
duration	textPropertyOptions
actorName	textPropertyOptions
userRating	integerPropertyOptions	orderedRanking, maximumValue
mpaaRating	textPropertyOptions

Définir les options pour les opérateurs

Outre les options spécifiques au type, chaque type possède un ensemble facultatif operatorOptions. Ces options décrivent la manière dont la propriété est utilisée en tant qu'opérateur de recherche. L'extrait de code suivant montre la propriété movieTitle avec le paramètre de type textPropertyOptions et les options spécifiques au type retrievalImportance et operatorOptions.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
      "operatorName": "title"
    }
  },
  ...
}

Avertissement : Sauf si vous êtes certain qu'une propriété doit être mieux classée que les autres dans les résultats de recherche, définissez retrievalImportance sur DEFAULT. Une fois définie, cette option ne peut plus être modifiée. Par exemple, si une propriété représente un titre, il est recommandé de lui attribuer l'importance HIGHEST. Toutefois, si une propriété contient des numéros de référence qui font référence à d'autres pièces, mais qui ne sont pas elles-mêmes, envisagez de marquer la propriété comme dont le niveau d'importance est FAIBLE. Si vous n'êtes pas sûr de l'importance de la propriété, utilisez DEFAULT. Si vous êtes certain que le texte ne doit pas être utilisé pour la récupération, utilisez NONE. Pour en savoir plus, consultez la section Importance.

Chaque operatorOptions a un operatorName, tel que title pour un movieTitle. Le nom de l'opérateur correspond à l'opérateur de recherche de la propriété. L'opérateur de recherche est le paramètre que les utilisateurs doivent utiliser pour affiner leur recherche. Par exemple, pour rechercher des films en fonction de leur titre, l'utilisateur doit saisir title:movieName, où movieName est le nom d'un film.

Les noms des opérateurs ne doivent pas nécessairement être identiques au nom de la propriété. Vous devez à la place utiliser des noms d'opérateur qui reflètent les mots les plus couramment utilisés par les utilisateurs de votre organisation. Par exemple, si vos utilisateurs préfèrent le terme "nom" à "titre" pour le titre d'un film, le nom de l'opérateur doit être défini sur "nom".

Remarque:Il est important d'exposer les noms des opérateurs aux utilisateurs, que ce soit dans les options de votre interface de recherche ou dans la documentation. Les utilisateurs doivent savoir quels opérateurs utiliser pour affiner leurs requêtes de recherche.

Vous pouvez utiliser le même nom d'opérateur pour plusieurs propriétés, à condition que toutes les propriétés soient associées au même type. Lorsque vous utilisez un nom d'opérateur partagé lors d'une requête, toutes les propriétés utilisant ce nom d'opérateur sont récupérées. Par exemple, supposons que l'objet "movie" ait les propriétés plotSummary et plotSynopsis, et que chacune de ces propriétés possède un operatorName de plot. Tant que ces deux propriétés sont du texte (textPropertyOptions), une seule requête utilisant l'opérateur de recherche plot les récupère.

En plus de operatorName, les propriétés qui peuvent être triées peuvent contenir des champs lessThanOperatorName et greaterThanOperatorName dans operatorOptions. Les utilisateurs peuvent utiliser ces options pour créer des requêtes basées sur des comparaisons avec une valeur envoyée.

Enfin, textOperatorOptions comporte un champ exactMatchWithOperator dans operatorOptions. Si vous définissez exactMatchWithOperator sur true, la chaîne de requête doit correspondre à la valeur de propriété entière, et pas seulement au texte. La valeur de texte est traitée comme une valeur atomique dans les recherches d'opérateurs et les correspondances d'attributs.

Par exemple, envisagez d'indexer des objets Livre ou Film avec des propriétés de genre. Genres possibles : "Science-Fiction", "Science" et "Fiction". Si exactMatchWithOperator est défini sur false ou omis, la recherche d'un genre ou la sélection de l'attribut "Science" ou "Fiction" renverra également les résultats de "Science-Fiction" puisque le texte est tokenisé, et que les jetons "Science" et "Fiction" existent en "&Fit" Science-Fiction. Lorsque exactMatchWithOperator est défini sur true, le texte est traité comme un jeton unique. Par conséquent, ni "Science", ni "Fiction" ne correspondent à "Science-Fiction".

(Facultatif) Ajoutez la section displayOptions.

Il existe une section displayOptions facultative à la fin de toute section propertyDefinition. Cette section contient une chaîne displayLabel. displayLabel est une étiquette de texte recommandée pour la propriété. Si la propriété est configurée pour l'affichage à l'aide de ObjectDisplayOptions, cette étiquette s'affiche devant la propriété. Si la propriété est configurée pour l'affichage et que displayLabel n'est pas défini, seule la valeur de la propriété est affichée.

L'extrait de code suivant montre la propriété movieTitle avec un displayLabel défini sur &Title.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
       "operatorName": "title"
    }
},
  "displayOptions": {
    "displayLabel": "Title"
  }
},

Voici les valeurs displayLabel pour toutes les propriétés de l'objet movie dans l'exemple de schéma:

Propriété	displayLabel
movieTitle	Title
releaseDate	Release date
genre	Genre
duration	Run length
actorName	Actor
userRating	Audience score
mpaaRating	MPAA rating

(Facultatif) Ajouter une section suggestionFilteringOperators[]

Vous trouverez une section suggestionFilteringOperators[] facultative à la fin de toute section propertyDefinition. Cette section vous permet de définir une propriété utilisée pour filtrer les suggestions de saisie semi-automatique. Par exemple, vous pouvez définir l'opérateur de genre pour filtrer les suggestions en fonction du genre de film préféré de l'utilisateur. Ensuite, lorsque l'utilisateur saisit sa requête de recherche, seuls les films correspondant à son genre préféré sont proposés dans les suggestions de saisie semi-automatique.

Remarque : Bien que ce champ soit un tableau, vous ne pouvez définir qu'un seul filtre de suggestions. Si vous définissez plusieurs filtres, seul le premier est reconnu.

Enregistrer votre schéma

Pour obtenir des données structurées à partir de requêtes Cloud Search, vous devez enregistrer votre schéma auprès du service de schéma Cloud Search. L'enregistrement d'un schéma nécessite l'ID de source de données que vous avez obtenu à l'étape Initialiser une source de données.

À l'aide de l'ID de source de données, émettez une requête UpdateSchema pour enregistrer votre schéma.

Comme indiqué sur la page de référence UpdateSchema, exécutez la requête HTTP suivante pour enregistrer votre schéma:

PUT https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/schema

Le corps de votre requête doit contenir les éléments suivants:

{
  "validateOnly": // true or false,
  "schema": {
    // ... Your complete schema object ...
  }
}

Utilisez l'option validateOnly pour tester la validité de votre schéma sans l'enregistrer.

Indexer vos données

Une fois le schéma enregistré, remplissez la source de données à l'aide d'appels Index. L'indexation s'effectue généralement dans le connecteur de contenu.

Avec le schéma de film, une requête d'indexation de l'API REST pour un seul film se présenterait comme suit:

{
  "name": "datasource/<data_source_id>/items/titanic",
  "acl": {
    "readers": [
      {
        "gsuitePrincipal": {
          "gsuiteDomain": true
        }
      }
    ]
  },
  "metadata": {
    "title": "Titanic",
    "sourceRepositoryUrl": "http://www.imdb.com/title/tt2234155/?ref_=nv_sr_1",
    "objectType": "movie"
  },
  "structuredData": {
    "object": {
      "properties": [
        {
          "name": "movieTitle",
          "textValues": {
            "values": [
              "Titanic"
            ]
          }
        },
        {
          "name": "releaseDate",
          "dateValues": {
            "values": [
              {
                "year": 1997,
                "month": 12,
                "day": 19
              }
            ]
          }
        },
        {
          "name": "actorName",
          "textValues": {
            "values": [
              "Leonardo DiCaprio",
              "Kate Winslet",
              "Billy Zane"
            ]
          }
        },
        {
          "name": "genre",
          "enumValues": {
            "values": [
              "Drama",
              "Action"
            ]
          }
        },
        {
          "name": "userRating",
          "integerValues": {
            "values": [
              8
            ]
          }
        },
        {
          "name": "mpaaRating",
          "textValues": {
            "values": [
              "PG-13"
            ]
          }
        },
        {
          "name": "duration",
          "textValues": {
            "values": [
              "3 h 14 min"
            ]
          }
        }
      ]
    }
  },
  "content": {
    "inlineContent": "A seventeen-year-old aristocrat falls in love with a kind but poor artist aboard the luxurious, ill-fated R.M.S. Titanic.",
    "contentFormat": "TEXT"
  },
  "version": "01",
  "itemType": "CONTENT_ITEM"
}

Notez que la valeur de movie dans le champ objectType correspond au nom de la définition d'objet dans le schéma. En faisant correspondre ces deux valeurs, Cloud Search sait quel objet de schéma utiliser lors de l'indexation.

Notez également que l'indexation de la propriété de schéma releaseDate utilise les sous-propriétés year, month et day dont elle hérite, car elle est définie en tant que type de données date via datePropertyOptions. Toutefois, étant donné que year, month et day ne sont pas définis dans le schéma, vous ne pouvez pas interroger l'une de ces propriétés (par exemple, year).

Notez également que la propriété reproductible actorName est indexée à l'aide d'une liste de valeurs.

Remarque : Le nom d'une propriété dans une requête d'indexation doit correspondre à la casse de la propriété dans le schéma, sinon une partie de la requête est supprimée en tant que propriété non enregistrée.

Identifier les problèmes d'indexation potentiels

Les deux problèmes les plus courants liés aux schémas et à l'indexation sont les suivants:

• Votre requête d'indexation contient un objet de schéma ou un nom de propriété qui n'a pas été enregistré auprès du service de schéma. Ce problème entraîne l'exclusion de la propriété ou de l'objet.

• Votre requête d'indexation possède une propriété dont la valeur de type est différente de celle enregistrée dans le schéma. Ce problème entraîne la génération par Cloud Search d'une erreur au moment de l'indexation.

Tester votre schéma avec plusieurs types de requêtes

Avant d'enregistrer votre schéma pour un dépôt de données de production volumineux, envisagez de le tester avec un dépôt de données de test plus petit. Les tests avec un dépôt de test plus petit vous permettent d'ajuster rapidement votre schéma et de supprimer les données indexées, sans affecter un index plus volumineux ou un index de production existant. Pour un dépôt de données de test, créez une LCA qui n'autorise qu'un utilisateur test afin que les autres utilisateurs n'aient pas accès à ces données dans les résultats de recherche.

Pour créer une interface de recherche afin de valider les requêtes de recherche, reportez-vous à la section Interface de recherche.

Cette section contient différents exemples de requêtes que vous pouvez utiliser pour tester un schéma de film.

Tester avec une requête générique

Une requête générique renvoie tous les éléments de la source de données contenant une chaîne spécifique. À l'aide d'une interface de recherche, vous pouvez exécuter une requête générique sur une source de données de films en saisissant le mot "titanic", puis en appuyant sur Entrée. Tous les films contenant le mot "titanic" doivent être renvoyés dans les résultats de recherche.

Tester avec un opérateur

L'ajout d'un opérateur à la requête limite les résultats aux éléments correspondant à cette valeur d'opérateur. Par exemple, vous pouvez utiliser l'opérateur actor pour rechercher tous les films dans lesquels joue un acteur particulier. À l'aide d'une interface de recherche, vous pouvez effectuer cette requête avec opérateur en saisissant simplement une paire operator=value, telle que "actor:Zane", puis en appuyant sur Entrée. Tous les films dans lesquels Zane apparaît comme acteur doivent être renvoyés dans les résultats de recherche.

Ajuster votre schéma

Une fois que votre schéma et vos données sont utilisés, continuez à surveiller ce qui fonctionne et ne fonctionne pas pour vos utilisateurs. Nous vous recommandons d'ajuster votre schéma dans les cas suivants:

• Indexation d'un champ qui n'avait pas encore été indexé Par exemple, vos utilisateurs peuvent rechercher plusieurs fois des films en fonction du nom du réalisateur. Vous pouvez donc ajuster votre schéma de sorte à accepter le nom du réalisateur en tant qu'opérateur.
• Modification du nom des opérateurs de recherche en fonction des commentaires des utilisateurs. Les noms d'opérateur sont conçus pour être conviviaux. Si vos utilisateurs se remémorent systématiquement le mauvais nom d'opérateur, vous pouvez envisager de le modifier.

Remarque:Lorsque le schéma est mis à jour ou supprimé, l'application de recherche est également mise à jour. Par exemple, si un opérateur de schéma est renommé, il l'est également dans la configuration de l'application de recherche. Si la mise à jour du schéma est incompatible avec l'application de recherche et qu'il n'est pas possible de la mettre à jour, la mise à jour du schéma échoue et une erreur est renvoyée dans la réponse de mise à jour.

Réindexation après un changement de schéma

La modification de l'une des valeurs suivantes dans votre schéma ne nécessite pas la réindexation de vos données. Il vous suffit d'envoyer une nouvelle requête UpdateSchema pour que votre index continue à fonctionner:

• Noms d'opérateur.
• Nombres entiers minimaux et maximaux.
• Classement ordonné des nombres entiers et des énumérations.
• Options d'actualisation
• Options d'affichage

Pour les modifications suivantes, les données précédemment indexées continueront de fonctionner selon le schéma précédemment enregistré. Toutefois, vous devez réindexer les entrées existantes pour voir les modifications basées sur le schéma mis à jour si elles présentent les changements suivants:

• Ajouter ou supprimer une propriété ou un objet
• Remplacement de isReturnable, isFacetable ou isSortable de false par true.

Définissez isFacetable ou isSortable sur true uniquement si vous avez un cas d'utilisation et un besoin évidents.

Enfin, lorsque vous mettez à jour votre schéma en marquant une propriété isSuggestable, vous devez réindexer vos données, ce qui retarde l'utilisation de la saisie semi-automatique pour cette propriété.

Modifications de propriété non autorisées

Certaines modifications de schéma ne sont pas autorisées, même si vous réindexez vos données, car elles vont endommager l'index ou produire des résultats de recherche incohérents ou de mauvaise qualité. Ces modifications incluent les changements suivants:

• Type de données de la propriété.
• Nom de propriété
• Paramètre exactMatchWithOperator.
• Paramètre retrievalImportance.

Il existe toutefois un moyen de contourner cette limitation.

Effectuer une modification de schéma complexe

Pour éviter les modifications susceptibles de générer de mauvais résultats de recherche ou un index de recherche défaillant, Cloud Search empêche certains types de modifications dans les requêtes UpdateSchema après l'indexation du dépôt. Par exemple, le type de données ou le nom d'une propriété ne peut pas être modifié une fois qu'ils ont été définis. Ces modifications ne peuvent pas être obtenues via une simple requête UpdateSchema, même si vous réindexez vos données.

Dans les cas où vous devez apporter une modification non autorisée à votre schéma, vous pouvez souvent apporter une série de modifications autorisées produisant le même effet. En général, cela implique de migrer des propriétés indexées d'une définition d'objet plus ancienne vers une propriété plus récente, puis d'envoyer une requête d'indexation utilisant uniquement la propriété la plus récente.

Pour modifier le type de données ou le nom d'une propriété, procédez comme suit:

1. Ajoutez une nouvelle propriété à la définition d'objet dans votre schéma. Utilisez un nom différent de celui de la propriété que vous souhaitez modifier.
2. Envoyez la requête UpdateSchema avec la nouvelle définition. N'oubliez pas d'envoyer l'intégralité du schéma, y compris la nouvelle et l'ancienne propriété, dans la requête.

3. Remplissez l'index à partir du dépôt de données. Pour remplir l'index, envoyez toutes les requêtes d'indexation à l'aide de la nouvelle propriété, mais pas l'ancienne, car cela entraînerait un double comptage des correspondances de requêtes.

   1. Lors du remplissage de l'index, recherchez la nouvelle propriété et utilisez l'ancienne propriété par défaut pour éviter tout comportement incohérent.
   2. Une fois le remplissage terminé, exécutez des requêtes de test pour vérifier.

4. Supprimez l'ancienne propriété. Émettez une autre requête UpdateSchema sans l'ancien nom de propriété et arrêtez d'utiliser l'ancien nom de propriété dans les futures requêtes d'indexation.

5. Migrez toute utilisation de l'ancienne propriété vers la nouvelle. Par exemple, si vous modifiez le nom de la propriété de "créateur" en "auteur", vous devez mettre à jour votre code de requête pour qu'il utilise "auteur" là où il faisait précédemment référence au créateur.

Cloud Search conserve une trace de toutes les propriétés et objets supprimés pendant 30 jours afin d'empêcher toute réutilisation susceptible de provoquer des résultats d'indexation inattendus. Au cours de ces 30 jours, vous devez abandonner toute utilisation de l'objet ou de la propriété supprimés, y compris en les omettant des requêtes d'index futures. Ainsi, si vous décidez par la suite de rétablir cette propriété ou cet objet, vous pourrez le faire de manière à maintenir l'exactitude de votre index.

Connaître les limites de taille

Cloud Search impose des limites à la taille des objets de données structurées et des schémas. Ces limites sont les suivantes:

• Le nombre maximal d'objets de niveau supérieur est de 10.
• La profondeur maximale d'une hiérarchie de données structurées est de 10 niveaux.
• Le nombre total de champs dans un objet est limité à 1 000, qui inclut le nombre de champs primitifs et la somme du nombre de champs dans chaque objet imbriqué.

Next Steps

Voici quelques étapes que vous pouvez également suivre :

1. Créez une interface de recherche pour tester votre schéma.

2. Ajustez votre schéma pour améliorer la qualité de la recherche.

3. Structurer un schéma pour une interprétation optimale des requêtes

4. Découvrez comment exploiter le schéma _dictionaryEntry pour définir des synonymes des termes couramment utilisés dans votre entreprise. Pour utiliser le schéma _dictionaryEntry, consultez Définir des synonymes.

5. Créez un connecteur.