Reference documentation and code samples for the Google Cloud Data Catalog V1 Client class SearchCatalogRequest.
Request message for SearchCatalog .
Generated from protobuf message google.cloud.datacatalog.v1.SearchCatalogRequest
Namespace
Google \ Cloud \ DataCatalog \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ scope
SearchCatalogRequest\Scope
Required. The scope of this search request. The scope
is invalid if include_org_ids
, include_project_ids
are empty AND include_gcp_public_datasets
is set to false
. In this case, the request returns an error.
↳ query
string
Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see Data Catalog search syntax
. An empty query string returns all data assets (in the specified scope) that you have access to. A query string can be a simple xyz
or qualified by predicates: * * name:x
* * column:y
* * description:z
↳ page_size
int
Upper bound on the number of results you can get in a single response. Can't be negative or 0, defaults to 10 in this case. The maximum number is 1000. If exceeded, throws an "invalid argument" exception.
↳ page_token
string
Optional. Pagination token that, if specified, returns the next page of search results. If empty, returns the first page. This token is returned in the SearchCatalogResponse.next_page_token field of the response to a previous SearchCatalogRequest call.
↳ order_by
string
Specifies the order of results. Currently supported case-sensitive values are: * * relevance
that can only be descending * * last_modified_timestamp [asc|desc]
with descending ( desc
) as default * * default
that can only be descending Search queries don't guarantee full recall. Results that match your query might not be returned, even in subsequent result pages. Additionally, returned (and not returned) results can vary if you repeat search queries. If you are experiencing recall issues and you don't have to fetch the results in any specific order, consider setting this parameter to default
. If this parameter is omitted, it defaults to the descending relevance
.
↳ admin_search
bool
Optional. If set, use searchAll permission granted on organizations from include_org_ids
and projects from include_project_ids
instead of the fine grained per resource permissions when filtering the search results. The only allowed order_by
criteria for admin_search mode is default
. Using this flags guarantees a full recall of the search results.
getScope
Required. The scope of this search request.
The scope
is invalid if include_org_ids
, include_project_ids
are
empty AND include_gcp_public_datasets
is set to false
. In this case,
the request returns an error.
hasScope
clearScope
setScope
Required. The scope of this search request.
The scope
is invalid if include_org_ids
, include_project_ids
are
empty AND include_gcp_public_datasets
is set to false
. In this case,
the request returns an error.
$this
getQuery
Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see Data Catalog search syntax .
An empty query string returns all data assets (in the specified scope)
that you have access to.
A query string can be a simple xyz
or qualified by predicates:
-
name:x
-
column:y
-
description:z
string
setQuery
Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see Data Catalog search syntax .
An empty query string returns all data assets (in the specified scope)
that you have access to.
A query string can be a simple xyz
or qualified by predicates:
-
name:x
-
column:y
-
description:z
var
string
$this
getPageSize
Upper bound on the number of results you can get in a single response.
Can't be negative or 0, defaults to 10 in this case. The maximum number is 1000. If exceeded, throws an "invalid argument" exception.
int
setPageSize
Upper bound on the number of results you can get in a single response.
Can't be negative or 0, defaults to 10 in this case. The maximum number is 1000. If exceeded, throws an "invalid argument" exception.
var
int
$this
getPageToken
Optional. Pagination token that, if specified, returns the next page of search results. If empty, returns the first page.
This token is returned in the SearchCatalogResponse.next_page_token field of the response to a previous SearchCatalogRequest call.
string
setPageToken
Optional. Pagination token that, if specified, returns the next page of search results. If empty, returns the first page.
This token is returned in the SearchCatalogResponse.next_page_token field of the response to a previous SearchCatalogRequest call.
var
string
$this
getOrderBy
Specifies the order of results.
Currently supported case-sensitive values are:
-
relevance
that can only be descending -
last_modified_timestamp [asc|desc]
with descending (desc
) as default -
default
that can only be descending Search queries don't guarantee full recall. Results that match your query might not be returned, even in subsequent result pages. Additionally, returned (and not returned) results can vary if you repeat search queries. If you are experiencing recall issues and you don't have to fetch the results in any specific order, consider setting this parameter todefault
. If this parameter is omitted, it defaults to the descendingrelevance
.
string
setOrderBy
Specifies the order of results.
Currently supported case-sensitive values are:
-
relevance
that can only be descending -
last_modified_timestamp [asc|desc]
with descending (desc
) as default -
default
that can only be descending Search queries don't guarantee full recall. Results that match your query might not be returned, even in subsequent result pages. Additionally, returned (and not returned) results can vary if you repeat search queries. If you are experiencing recall issues and you don't have to fetch the results in any specific order, consider setting this parameter todefault
. If this parameter is omitted, it defaults to the descendingrelevance
.
var
string
$this
getAdminSearch
Optional. If set, use searchAll permission granted on organizations from include_org_ids
and projects from include_project_ids
instead of the
fine grained per resource permissions when filtering the search results.
The only allowed order_by
criteria for admin_search mode is default
.
Using this flags guarantees a full recall of the search results.
bool
setAdminSearch
Optional. If set, use searchAll permission granted on organizations from include_org_ids
and projects from include_project_ids
instead of the
fine grained per resource permissions when filtering the search results.
The only allowed order_by
criteria for admin_search mode is default
.
Using this flags guarantees a full recall of the search results.
var
bool
$this
static::build
scope
SearchCatalogRequest\Scope
Required. The scope of this search request.
The scope
is invalid if include_org_ids
, include_project_ids
are
empty AND include_gcp_public_datasets
is set to false
. In this case,
the request returns an error.
query
string
Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see Data Catalog search syntax .
An empty query string returns all data assets (in the specified scope) that you have access to.
A query string can be a simple xyz
or qualified by predicates:
-
-
name:x
-
-
-
column:y
-
-
-
description:z
-