mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-15 09:25:44 +00:00
85 lines
3.4 KiB
Text
85 lines
3.4 KiB
Text
NAME
|
|
gcloud dataplex context lookup - looks up LLM context for data assets
|
|
|
|
SYNOPSIS
|
|
gcloud dataplex context lookup --resources=[RESOURCES,...]
|
|
[--location=LOCATION] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
Looks up LLM context for data assets.
|
|
|
|
Fetches detailed contextual metadata for the specified data assets. Data
|
|
assets can be identified by their Dataplex entry name, source system
|
|
resource name or fully qualified name. The returned context can include
|
|
schema, descriptions, business annotations, data quality insights, and
|
|
relationships, structured for application use. This output is particularly
|
|
useful for providing grounding to Large Language Models (LLMs), enabling
|
|
more accurate and context-aware interactions with your data.
|
|
|
|
EXAMPLES
|
|
To look up Dataplex Context for BigQuery tables 'table1' and 'table2' in
|
|
dataset 'my-dataset' within project 'test-dataplex' in location
|
|
'us-central1', run:
|
|
|
|
$ gcloud dataplex context lookup --location=us-central1 \
|
|
--project=test-dataplex --resources=resource1,resource2
|
|
|
|
To look up context using Dataplex entry names:
|
|
|
|
$ gcloud dataplex context lookup --location=us-central1 \
|
|
--project=test-dataplex \
|
|
--resources=projects/test-dataplex/locations/us-central1/\
|
|
entryGroups/my-group/entries/my-entry
|
|
|
|
To look up context using the default project and location from your gcloud
|
|
configuration:
|
|
|
|
$ gcloud dataplex context lookup --resources=resource1,resource2
|
|
|
|
REQUIRED FLAGS
|
|
--resources=[RESOURCES,...]
|
|
The identifier describing the resource,
|
|
◆ in the form of a entry name, or
|
|
◆ in the form of a linked resource name, or
|
|
◆ in the form of a fully qualified name. Examples:
|
|
◆ projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}
|
|
◆ bigquery:{project}.{dataset}.{table}
|
|
|
|
OPTIONAL FLAGS
|
|
Location resource - The Dataplex location for the context lookup. If not
|
|
specified, the location will be taken from the dataplex/location property
|
|
in your gcloud configuration. This represents a Cloud resource. (NOTE)
|
|
Some attributes are not given arguments in this group but can be set in
|
|
other ways.
|
|
|
|
To set the project attribute:
|
|
◆ provide the argument --location on the command line with a fully
|
|
specified name;
|
|
◆ set the property dataplex/location with a fully specified name;
|
|
◆ provide the argument --project on the command line;
|
|
◆ set the property core/project.
|
|
|
|
--location=LOCATION
|
|
ID of the location or fully qualified identifier for the location.
|
|
|
|
To set the location attribute:
|
|
◆ provide the argument --location on the command line;
|
|
◆ set the property dataplex/location.
|
|
|
|
GCLOUD WIDE FLAGS
|
|
These flags are available to all commands: --access-token-file, --account,
|
|
--billing-project, --configuration, --flags-file, --flatten, --format,
|
|
--help, --impersonate-service-account, --log-http, --project, --quiet,
|
|
--trace-token, --user-output-enabled, --verbosity.
|
|
|
|
Run $ gcloud help for details.
|
|
|
|
API REFERENCE
|
|
This command uses the dataplex/v1 API. The full documentation for this API
|
|
can be found at: https://cloud.google.com/dataplex/docs
|
|
|
|
NOTES
|
|
This variant is also available:
|
|
|
|
$ gcloud alpha dataplex context lookup
|
|
|