Utilizzare la ricerca solo per parole chiave in Knowledge Catalog

Nota :per eseguire query sui dati di Knowledge Catalog, utilizza la ricerca di Knowledge Catalog. Utilizza la ricerca solo per parole chiave solo per la compatibilità con le versioni precedenti.

Utilizza la ricerca solo per parole chiave in Knowledge Catalog per trovare risorse utilizzando parole chiave, filtri e una sintassi definiti. La ricerca solo per parola chiave offre un controllo preciso sulle query di ricerca e consente di restringere i risultati in base ai campi dei metadati.

Prima di iniziare

Prima di eseguire la ricerca, assicurati di disporre dei ruoli richiesti e di aver abilitato l'API necessaria.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per cercare voci e accedere ai risultati di ricerca in Knowledge Catalog, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Cercare voci:
  • Dataplex Catalog Admin (roles/dataplex.catalogAdmin) sul progetto utilizzato per la ricerca
  • Editor di Dataplex Catalog (roles/dataplex.catalogEditor) sul progetto utilizzato per la ricerca
  • Visualizzatore di Dataplex Catalog (roles/dataplex.catalogViewer) sul progetto utilizzato per la ricerca
• Cerca i metadati per i set di dati e le tabelle BigQuery: Visualizzatore metadati BigQuery (roles/bigquery.metadataViewer) sul set di dati o sulla tabella
• Cerca le voci personalizzate: Dataplex Catalog Viewer (roles/dataplex.catalogViewer) sul progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Utilizzare la ricerca solo per parola chiave

Console

Per cercare risorse utilizzando la ricerca per parole chiave:

1. Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.

   Vai a Cerca

2. Se la piattaforma di ricerca è impostata su Data Catalog, seleziona Knowledge Catalog nel menu Scegli la piattaforma di ricerca.

3. Nel campo Trova risorse tra progetti, inserisci la query.

4. Per perfezionare la ricerca, utilizza il riquadro Filtri. Sono disponibili i seguenti filtri:

   • Sistemi fornisce un elenco dei sistemi disponibili, ad esempio BigQuery o Cloud SQL. Il sistema Knowledge Catalog contiene voci personalizzate.
   • Gli aspetti (tag) ti consentono di eseguire query sugli asset taggati utilizzando un modello specifico. Puoi utilizzare il menu Personalizza per perfezionare ulteriormente i risultati e filtrare in base a valori di aspetti specifici.
   • Progetto elenca i progetti a cui puoi limitare la ricerca.
   • Gli alias del tipo sono tipi di dati associati a un tipo di voce. Un tipo di voce potrebbe avere il nome projects/test-project/locations/us/entryTypes/my-entry-type, ma puoi cercarlo utilizzando gli alias di tipo TABLE o DATABASE. Puoi impostare uno o più alias di tipo quando crei o aggiorni un tipo di voce.
   • I set di dati provengono da BigQuery.

   Puoi aggiungere manualmente i seguenti filtri:

   • Aggiungi un filtro per progetto: in Progetto, fai clic su Aggiungi progetto. Cerca un progetto specifico, selezionalo e poi fai clic su Apri.
   • Aggiungi un filtro per tipo di aspetto: in Aspetti, fai clic sul menu Aggiungi altri tipi di aspetto. Cerca un modello specifico, selezionalo e fai clic su Ok.

5. (Facoltativo) Oltre agli asset a tua disposizione, puoi cercare risorse disponibili pubblicamente in Google Cloud selezionando Includi set di dati pubblici.

   Utilizza i seguenti suggerimenti per creare una query di ricerca:

   • Racchiudi l'espressione di ricerca tra virgolette se contiene spazi. Ad esempio, "search terms".
   • Precedi una parola chiave con NOT per trovare la negazione logica del filtro keyword:term. Puoi anche utilizzare gli operatori booleani AND e OR per combinare le espressioni di ricerca. Gli operatori AND, OR e NOT non sono sensibili alle maiuscole.

   Ad esempio, NOT column:term elenca tutte le colonne tranne quelle che corrispondono al termine specificato.

6. Per visualizzare ulteriori informazioni sulla risorsa cercata, fai clic sul nome della risorsa nei risultati di ricerca. Viene visualizzata la pagina dei dettagli della voce.

gcloud

Per cercare risorse, utilizza il comando gcloud dataplex entries search.

C#

C#

Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

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;
    }
}

Vai

Go

Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

//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

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

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

Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

/**
 * 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

Prima di provare questo esempio, segui le istruzioni di configurazione di PHP nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog PHP.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

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

Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

# 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

Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

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

Per cercare risorse, utilizza il metodo searchEntries.

Sintassi di ricerca solo per parole chiave

Per ricerche precise, puoi creare una query utilizzando una sintassi specifica, inclusi qualificatori, operatori logici e ricerche per aspetto.

Predicati qualificati

Puoi qualificare un predicato anteponendogli una chiave che limita la corrispondenza a un metadato specifico:

• Il segno di uguale (=) limita la ricerca a una corrispondenza esatta.
• I due punti (:) dopo la chiave corrispondono al predicato a una sottostringa o a un token all'interno del valore nei risultati di ricerca.

La tokenizzazione suddivide il flusso di testo in una serie di token, ognuno dei quali corrisponde in genere a una singola parola.

Le chiavi predicato type, system, location e orgid supportano solo il qualificatore corrispondenza esatta (=), non il qualificatore sottostringa (:). Ad esempio, type=foo o orgid=number.

La ricerca per parole chiave di Knowledge Catalog supporta i seguenti qualificatori:

Qualificatore	Descrizione
name:x	Corrisponde a x come sottostringa dell'ID risorsa.
displayname:x	Corrisponde a x come sottostringa del nome visualizzato della risorsa.
column:x	Corrisponde a x come sottostringa del nome della colonna (o del nome della colonna nidificata) nello schema della risorsa.
description:x	Corrisponde a x come token nella descrizione della risorsa.
label:bar	Corrisponde alle risorse BigQuery che hanno un'etichetta (con un valore) e la cui chiave di etichetta contiene bar come sottostringa.
label=bar	Corrisponde alle risorse BigQuery che hanno un'etichetta (con un valore) e la cui chiave di etichetta è uguale a bar come stringa.
label:bar:x	Corrisponde a x come sottostringa nel valore di un'etichetta con chiave bar collegata a una risorsa BigQuery.
label=foo:bar	Corrisponde alle risorse BigQuery in cui la chiave è uguale a foo e il valore della chiave è uguale a bar.
label.foo=bar	Corrisponde alle risorse BigQuery in cui la chiave è uguale a foo e il valore della chiave è uguale a bar.
label.foo	Corrisponde alle risorse BigQuery che hanno un'etichetta la cui chiave è uguale a foo come stringa.
type=TYPE	Corrisponde alle risorse di un tipo di voce specifico o al relativo alias di tipo.
projectid:bar	Trova le risorse all'interno dei progetti Google Cloud che corrispondono a bar come sottostringa nell'ID.
parent:x	Corrisponde a x come sottostringa del percorso gerarchico di una risorsa. Il percorso padre è un fully_qualified_name della risorsa padre.
orgid=number	Corrisponde alle risorse all'interno di un'organizzazione Google Cloud con il valore ID esatto di number.
system=SYSTEM	Corrisponde alle risorse di un sistema specificato.
location=LOCATION	Corrisponde alle risorse in una posizione specificata con un nome esatto. Ad esempio, location=us-central1 corrisponde agli asset ospitati in Iowa. Gli asset BigQuery Omni supportano questo qualificatore utilizzando il nome della località BigQuery Omni. Ad esempio, location=aws-us-east-1 corrisponde agli asset BigQuery Omni in Virginia del Nord.
createtime	Trova le risorse create entro, prima o dopo una determinata data o ora. Ad esempio: createtime:2019-01-01 corrisponde alle risorse create il giorno 2019-01-01. createtime<2019-02 corrisponde alle risorse create prima del giorno 2019-02-01T00:00:00. createtime>2019-02 corrisponde alle risorse create dopo il 2019-02-01T00:00:00. Formato del timestamp: YYYY-MM-DDThh:mm:ss Tutti i timestamp devono essere in formato GMT; i fusi orari non sono supportati. Sono supportati timestamp parziali, separatori di date con trattino (-) e separatori di date con barra (/). Ad esempio: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
updatetime	Trova le risorse aggiornate entro, prima o dopo una determinata data o ora. Ad esempio: updatetime:2019-01-01 corrisponde alle risorse aggiornate il giorno 2019-01-01. updatetime<2019-02 corrisponde alle risorse aggiornate prima del 2019-02-01T00:00:00. updatetime>2019-02 corrisponde alle risorse aggiornate dopo il 01/02/2019T00:00:00. Formato del timestamp: YYYY-MM-DDThh:mm:ss Tutti i timestamp devono essere in formato GMT; i fusi orari non sono supportati. Sono supportati timestamp parziali, separatori di date con trattino (-) e separatori di date con barra (/). Ad esempio: 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	Corrisponde a x come sottostringa di fully_qualified_name.
fully_qualified_name=x	Corrispondenze x come fully_qualified_name.

Ricerca per aspetto

Per cercare voci in base agli aspetti allegati, utilizza la seguente sintassi della query.

Nota: la corrispondenza della sottostringa tenta di trovare una corrispondenza con un numero limitato di aspetti. Se non riesci a trovare la voce utilizzando un frammento del percorso, utilizza il percorso completo per restringere la ricerca e aumentare il richiamo.

Qualificatore	Descrizione
aspect:x	Corrisponde a x come sottostringa del percorso completo del tipo di aspetto di un aspetto allegato alla voce, nel formato projectid.location.ASPECT_TYPE_ID
aspect=x	Corrisponde a x come percorso completo al tipo di aspetto di un aspetto allegato alla voce, nel formato projectid.location.ASPECT_TYPE_ID
aspect:xOPERATORvalue	Cerca i valori dei campi degli aspetti. Corrisponde a x come sottostringa del percorso completo del tipo di aspetto e del nome del campo di un aspetto allegato alla voce, nel formato projectid.location.ASPECT_TYPE_ID.FIELD_NAME L'elenco degli operatori supportati dipende dal tipo di campo nell'aspetto, come segue: Stringa: = (corrispondenza esatta) e : (sottostringa) Tutti i tipi di numeri: =, :, <, >, <=, >=, =>, =< Enum: = Data e ora: come per i numeri, ma i valori da confrontare vengono trattati come date e ore anziché come numeri Valore booleano: = Solo i campi di primo livello dell'aspetto sono ricercabili. Ad esempio, tutte le seguenti query corrispondono alle voci in cui il valore del campo is-enrolled nell'aspetto employee-info è true. Vengono restituite anche altre voci che corrispondono alla sottostringa. aspect:example-project.us-central1.employee-info.is-enrolled=true aspect:example-project.us-central1.employee=true aspect:employee=true

Operatori logici

Una query può essere costituita da più predicati collegati con gli operatori logici AND, OR o NOT.

• Se non specifichi un operatore, viene utilizzato l'operatore logico AND. Ad esempio, foo bar restituisce le risorse che corrispondono sia al predicato foo sia al predicato bar.
• Nega un predicato con un prefisso - (trattino) o NOT. Ad esempio, -name:foo restituisce risorse con nomi che non corrispondono al predicato foo.

Nella ricerca solo per parole chiave, gli operatori logici non sono sensibili alle maiuscole.

Sintassi abbreviata

Per utilizzare la sintassi abbreviata nelle query, utilizza | (barra verticale) per gli operatori OR e , (virgola) per gli operatori AND. La sintassi abbreviata funziona per i predicati qualificati, ad eccezione di label.

Gli esempi seguenti mostrano come utilizzare la sintassi abbreviata con la ricerca solo per parole chiave.

• Cercare voci all'interno di uno dei tanti progetti utilizzando l'operatore OR

  projectid:(id1|id2|id3|id4)
  

  La stessa ricerca senza utilizzare la sintassi abbreviata ha il seguente aspetto:

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

• Cerca voci con nomi di colonne corrispondenti:

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

Passaggi successivi

• Scopri di più sulla gestione dei metadati in Knowledge Catalog.
• Scopri come arricchire le voci e i relativi link con i metadati utilizzando gli aspetti.
• Scopri come gestire le voci e importare origini personalizzate.