Utiliser la recherche par mots clés uniquement dans Knowledge Catalog

Remarque : Pour interroger les données Knowledge Catalog, utilisez la recherche Knowledge Catalog. N'utilisez la recherche par mots clés uniquement que pour la rétrocompatibilité.

Utilisez la recherche par mots clés uniquement dans Knowledge Catalog pour trouver des ressources à l'aide de mots clés et de filtres spécifiques, ainsi que d'une syntaxe définie. La recherche par mots clés uniquement vous permet de contrôler précisément vos requêtes de recherche et d'affiner les résultats en fonction des champs de métadonnées.

Avant de commencer

Avant d'effectuer une recherche, assurez-vous de disposer des rôles requis et d'avoir activé l'API nécessaire.

Rôles requis

Pour obtenir les autorisations nécessaires pour rechercher des entrées et accéder aux résultats de recherche dans Knowledge Catalog, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Rechercher des entrées :
  • Administrateur de catalogue Dataplex (roles/dataplex.catalogAdmin) sur le projet utilisé pour la recherche
  • Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor) sur le projet utilisé pour la recherche
  • Lecteur de catalogue Dataplex (roles/dataplex.catalogViewer) sur le projet utilisé pour la recherche
• Recherchez les métadonnées des ensembles de données et des tables BigQuery : Lecteur de métadonnées BigQuery (roles/bigquery.metadataViewer) sur l'ensemble de données ou la table
• Rechercher des entrées personnalisées : Lecteur de catalogue Dataplex (roles/dataplex.catalogViewer) sur le projet

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Utiliser la recherche par mots clés uniquement

Console

Pour rechercher des ressources à l'aide de la recherche par mot clé, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Rechercher de Knowledge Catalog.

   Accéder à la recherche

2. Si votre plate-forme de recherche est définie sur Data Catalog, dans le menu Choisir une plate-forme de recherche, sélectionnez Knowledge Catalog.

3. Dans le champ Rechercher des ressources dans plusieurs projets, saisissez votre requête.

4. Pour affiner votre recherche, utilisez le panneau Filtres. Les filtres suivants sont disponibles :

   • Les systèmes fournissent une liste des systèmes disponibles, tels que BigQuery ou Cloud SQL. Le système Knowledge Catalog contient des entrées personnalisées.
   • Les aspects (tags) vous permettent de rechercher des composants tagués à l'aide d'un modèle spécifique. Vous pouvez utiliser le menu Personnaliser pour affiner davantage les résultats et les filtrer par valeurs d'aspect spécifiques.
   • Projet liste les projets dans lesquels vous pouvez limiter la recherche.
   • Les alias de type sont des types de données associés à un type d'entrée. Un type d'entrée peut porter le nom projects/test-project/locations/us/entryTypes/my-entry-type, mais vous pouvez le rechercher à l'aide de ses alias de type TABLE ou DATABASE. Vous pouvez définir un ou plusieurs alias de type lorsque vous créez ou mettez à jour un type d'entrée.
   • Les ensembles de données proviennent de BigQuery.

   Vous pouvez ajouter manuellement les filtres suivants :

   • Ajouter un filtre de projet : dans Projet, cliquez sur Ajouter un projet. Recherchez un projet précis, sélectionnez-le, puis cliquez sur Ouvrir.
   • Ajouter un filtre de type d'aspect : dans Aspects, cliquez sur le menu Ajouter d'autres types d'aspects. Recherchez un modèle précis, sélectionnez-le, puis cliquez sur OK.

5. Facultatif : En plus des éléments auxquels vous avez accès, vous pouvez rechercher des ressources accessibles publiquement dans Google Cloud en sélectionnant Inclure des ensembles de données publics.

   Suivez les conseils ci-dessous pour créer une requête de recherche :

   • Placez votre expression de recherche entre guillemets si elle contient des espaces Par exemple, "search terms".
   • Ajoutez NOT devant un mot clé pour appliquer la négation logique du filtre keyword:term. Vous pouvez également utiliser les opérateurs booléens AND et OR pour combiner des expressions de recherche. Les opérateurs AND, OR et NOT ne sont pas sensibles à la casse.

   Par exemple, NOT column:term liste toutes les colonnes, sauf celles qui correspondent au terme spécifié.

6. Pour afficher plus d'informations sur la ressource recherchée, cliquez sur son nom dans les résultats de recherche. La page des détails de l'entrée s'ouvre.

gcloud

Pour rechercher des ressources, utilisez la commande gcloud dataplex entries search.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour C#.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Api.Gax;
using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using System;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for SearchEntries</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void SearchEntriesRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        SearchEntriesRequest request = new SearchEntriesRequest
        {
            LocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Query = "",
            OrderBy = "",
            Scope = "",
            SemanticSearch = false,
        };
        // Make the request
        PagedEnumerable<SearchEntriesResponse, SearchEntriesResult> response = catalogServiceClient.SearchEntries(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (SearchEntriesResult item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (SearchEntriesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (SearchEntriesResult item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<SearchEntriesResult> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (SearchEntriesResult item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Go

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour Go.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.SearchEntriesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#SearchEntriesRequest.
	}
	it := c.SearchEntries(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*dataplexpb.SearchEntriesResponse)
	}
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour Java.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.LocationName;
import com.google.cloud.dataplex.v1.SearchEntriesRequest;
import com.google.cloud.dataplex.v1.SearchEntriesResult;

public class SyncSearchEntries {

  public static void main(String[] args) throws Exception {
    syncSearchEntries();
  }

  public static void syncSearchEntries() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      SearchEntriesRequest request =
          SearchEntriesRequest.newBuilder()
              .setName(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setQuery("query107944136")
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setOrderBy("orderBy-1207110587")
              .setScope("scope109264468")
              .setSemanticSearch(true)
              .build();
      for (SearchEntriesResult element : catalogServiceClient.searchEntries(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

Node.js

Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour Node.js.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The project to which the request should be attributed in the
 *  following form: `projects/{project}/locations/global`.
 */
// const name = 'abc123'
/**
 *  Required. The query against which entries in scope should be matched.
 *  The query syntax is defined in Search syntax for Dataplex Universal
 *  Catalog (https://cloud.google.com/dataplex/docs/search-syntax).
 */
// const query = 'abc123'
/**
 *  Optional. Number of results in the search page. If <=0, then defaults
 *  to 10. Max limit for page_size is 1000. Throws an invalid argument for
 *  page_size > 1000.
 */
// const pageSize = 1234
/**
 *  Optional. Page token received from a previous `SearchEntries` call. Provide
 *  this to retrieve the subsequent page.
 */
// const pageToken = 'abc123'
/**
 *  Optional. Specifies the ordering of results.
 *  Supported values are:
 *  * `relevance`
 *  * `last_modified_timestamp`
 *  * `last_modified_timestamp asc`
 */
// const orderBy = 'abc123'
/**
 *  Optional. The scope under which the search should be operating. It must
 *  either be `organizations/<org_id>` or `projects/<project_ref>`. If it is
 *  unspecified, it defaults to the organization where the project provided in
 *  `name` is located.
 */
// const scope = 'abc123'
/**
 *  Optional. Specifies whether the search should understand the meaning and
 *  intent behind the query, rather than just matching keywords.
 */
// const semanticSearch = true

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callSearchEntries() {
  // Construct request
  const request = {
    name,
    query,
  };

  // Run request
  const iterable = dataplexClient.searchEntriesAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callSearchEntries();

PHP

PHP

Avant d'essayer cet exemple, suivez les instructions de configuration pour PHP du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour PHP.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Dataplex\V1\Client\CatalogServiceClient;
use Google\Cloud\Dataplex\V1\SearchEntriesRequest;
use Google\Cloud\Dataplex\V1\SearchEntriesResult;

/**
 * Searches for Entries matching the given query and scope.
 *
 * @param string $formattedName The project to which the request should be attributed in the
 *                              following form: `projects/{project}/locations/global`. Please see
 *                              {@see CatalogServiceClient::locationName()} for help formatting this field.
 * @param string $query         The query against which entries in scope should be matched.
 *                              The query syntax is defined in [Search syntax for Dataplex Universal
 *                              Catalog](https://cloud.google.com/dataplex/docs/search-syntax).
 */
function search_entries_sample(string $formattedName, string $query): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $request = (new SearchEntriesRequest())
        ->setName($formattedName)
        ->setQuery($query);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $catalogServiceClient->searchEntries($request);

        /** @var SearchEntriesResult $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = CatalogServiceClient::locationName('[PROJECT]', '[LOCATION]');
    $query = '[QUERY]';

    search_entries_sample($formattedName, $query);
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour Python.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_search_entries():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.SearchEntriesRequest(
        name="name_value",
        query="query_value",
    )

    # Make the request
    page_result = client.search_entries(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby du guide de démarrage rapide de Knowledge Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Knowledge Catalog pour Ruby.

Pour vous authentifier auprès de Knowledge Catalog, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the search_entries call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#search_entries.
#
def search_entries
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::SearchEntriesRequest.new

  # Call the search_entries method.
  result = client.search_entries request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::Dataplex::V1::SearchEntriesResult.
    p item
  end
end

REST

Pour rechercher des ressources, utilisez la méthode searchEntries.

Syntaxe de recherche avec mots clés uniquement

Pour effectuer des recherches précises, vous pouvez créer une requête à l'aide d'une syntaxe spécifique, y compris des qualificatifs, des opérateurs logiques et des recherches par aspect.

Prédicats qualifiés

Vous pouvez qualifier un prédicat en le préfixant avec une clé qui limite la correspondance à une métadonnée spécifique :

• Le signe égal (=) limite la recherche à une correspondance exacte.
• Le signe deux-points (:) après la clé correspond au prédicat d'une sous-chaîne ou d'un jeton compris dans la valeur des résultats de recherche.

La tokenisation divise le flux de texte en une série de jetons, chaque jeton correspondant généralement à un seul mot.

Les clés de prédicat type, system, location et orgid n'acceptent que le qualificatif de correspondance exacte (=), et non celui de sous-chaîne (:). Par exemple, type=foo ou orgid=number.

La recherche de mots clés dans Knowledge Catalog accepte les qualificatifs suivants :

Qualificatif	Description
name:x	Renvoie x en tant que sous-chaîne de l'ID de ressource.
displayname:x	Renvoie x en tant que sous-chaîne du nom à afficher de la ressource.
column:x	Correspond à x en tant que sous-chaîne du nom de la colonne (ou du nom de la colonne imbriquée) dans le schéma de la ressource.
description:x	Renvoie x en tant que jeton dans la description de la ressource.
label:bar	Renvoie les ressources BigQuery comportant une étiquette (avec une certaine valeur) et dont la clé d'étiquette est bar en tant que sous-chaîne.
label=bar	Renvoie les ressources BigQuery comportant une étiquette (avec une certaine valeur) et dont la clé d'étiquette est égale à bar en tant que chaîne.
label:bar:x	Renvoie x en tant que sous-chaîne dans la valeur d'une étiquette avec la clé bar associée à une ressource BigQuery.
label=foo:bar	Renvoie les ressources BigQuery dont la clé est égale à foo et la valeur de clé est égale à bar.
label.foo=bar	Renvoie les ressources BigQuery dont la clé est égale à foo et la valeur de clé est égale à bar.
label.foo	Renvoie les ressources BigQuery comportant une étiquette dont la clé est égale à foo sous forme de chaîne.
type=TYPE	Correspond aux ressources d'un type d'entrée spécifique ou de son alias de type.
projectid:bar	Renvoie les ressources dans les projets Google Cloud qui correspondent àbaren tant que sous-chaîne dans l'ID.
parent:x	Correspond à x en tant que sous-chaîne du chemin d'accès hiérarchique d'une ressource. Le chemin parent est un fully_qualified_name de la ressource parente.
orgid=number	Fait correspondre les ressources d'une organisation Google Cloud avec la valeur d'ID exacte number.
system=SYSTEM	Correspond aux ressources d'un système spécifié.
location=LOCATION	Fait correspondre les ressources d'un emplacement spécifié avec un nom exact. Par exemple, location=us-central1 correspond aux composants hébergés dans l'Iowa. Les composants BigQuery Omni sont compatibles avec ce qualificatif en utilisant le nom de l'emplacement BigQuery Omni. Par exemple, location=aws-us-east-1 correspond aux composants BigQuery Omni en Virginie du Nord.
createtime	Recherche les ressources qui ont été créées pendant, avant ou après une date ou une heure donnée. Exemple : createtime:2019-01-01 correspond aux ressources créées le 1er janvier 2019. createtime<2019-02 correspond aux ressources créées avant le 2019-02-01T00:00:00. createtime>2019-02 correspond aux ressources créées après le 01/02/2019 à 00:00:00. Format du code temporel : YYYY-MM-DDThh:mm:ss Tous les horodatages doivent être à l'heure GMT (les fuseaux horaires ne sont pas acceptés). Les codes temporels partiels et les séparateurs de date (tiret - et barre oblique /) sont acceptés. Exemple : 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
updatetime	Recherche les ressources qui ont été mises à jour pendant, avant ou après une date ou une heure donnée. Exemple : updatetime:2019-01-01 correspond aux ressources mises à jour le 1er janvier 2019. updatetime<2019-02 correspond aux ressources mises à jour avant le 2019-02-01T00:00:00. updatetime>2019-02 correspond aux ressources mises à jour après le 1er février 2019 à 00h00. Format du code temporel : YYYY-MM-DDThh:mm:ss Tous les horodatages doivent être à l'heure GMT (les fuseaux horaires ne sont pas acceptés). Les codes temporels partiels et les séparateurs de date (tiret - et barre oblique /) sont acceptés. Exemple : 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
fully_qualified_name:x	Renvoie x en tant que sous-chaîne de fully_qualified_name.
fully_qualified_name=x	Correspondances : x en tant que fully_qualified_name.

Recherche par aspect

Pour rechercher des entrées en fonction de leurs aspects associés, utilisez la syntaxe de requête suivante.

Remarque : La correspondance de sous-chaîne tente de faire correspondre un nombre limité d'aspects. Si vous ne trouvez pas l'entrée à l'aide d'un fragment du chemin d'accès, utilisez le chemin d'accès complet pour affiner la recherche et augmenter le rappel.

Qualificatif	Description
aspect:x	Correspond à x en tant que sous-chaîne du chemin d'accès complet au type d'aspect d'un aspect associé à l'entrée, au format projectid.location.ASPECT_TYPE_ID
aspect=x	Correspond à x en tant que chemin d'accès complet au type d'aspect d'un aspect associé à l'entrée, au format projectid.location.ASPECT_TYPE_ID
aspect:xOPERATORvalue	Recherche des valeurs de champ d'aspect. Correspond à x en tant que sous-chaîne du chemin d'accès complet au type d'aspect et au nom de champ d'un aspect associé à l'entrée, au format projectid.location.ASPECT_TYPE_ID.FIELD_NAME. La liste des opérateurs acceptés dépend du type de champ dans l'aspect, comme suit : Chaîne : = (correspondance exacte) et : (sous-chaîne) Tous les types de nombres : =, :, <, >, <=, >=, =>, =< Enum : = Date et heure : identique à la comparaison de nombres, mais les valeurs à comparer sont traitées comme des valeurs de date et heure plutôt que comme des nombres. Booléen : = Seuls les champs de premier niveau de l'aspect peuvent faire l'objet d'une recherche. Par exemple, toutes les requêtes suivantes correspondent aux entrées où la valeur du champ is-enrolled dans l'aspect employee-info est true. D'autres entrées correspondant à la sous-chaîne sont également renvoyées. aspect:example-project.us-central1.employee-info.is-enrolled=true aspect:example-project.us-central1.employee=true aspect:employee=true

Opérateurs logiques

Une requête peut se composer de plusieurs prédicats liés par des opérateurs logiques AND, OR ou NOT.

• Si vous ne spécifiez pas d'opérateur, l'opérateur logique AND est implicite. Par exemple, foo bar renvoie les ressources qui correspondent à la fois au prédicat foo et au prédicat bar.
• Annulez un prédicat avec les préfixes - (tiret) ou NOT. Par exemple, -name:foo renvoie les ressources dont le nom ne correspond pas au prédicat foo.

Dans la recherche par mots clés uniquement, les opérateurs logiques ne sont pas sensibles à la casse.

Syntaxe abrégée

Pour utiliser la syntaxe abrégée dans vos requêtes, utilisez | (barre verticale) pour les opérateurs OR et , (virgule) pour les opérateurs AND. La syntaxe abrégée fonctionne pour les prédicats qualifiés, à l'exception de label.

Les exemples suivants montrent comment utiliser la syntaxe abrégée avec la recherche par mot clé uniquement.

• Rechercher des entrées dans l'un des nombreux projets à l'aide de l'opérateur OR

  projectid:(id1|id2|id3|id4)
  

  La même recherche sans utiliser la syntaxe abrégée se présente comme suit :

  projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4
  

• Pour rechercher des entrées avec des noms de colonne correspondants :

  • AND : column:(name1,name2,name3)
  • OU : column:(name1|name2|name3)

Étapes suivantes

• En savoir plus sur la gestion des métadonnées dans Knowledge Catalog
• Découvrez comment enrichir des entrées et des liens vers des entrées avec des métadonnées à l'aide des aspects.
• Apprenez à gérer les entrées et ingérer des sources personnalisées.