Google Cloud Data Catalog V1 Client - Class SearchCatalogRequest (1.5.1)

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 \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ scope Google\Cloud\DataCatalog\V1\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

Number of results to return in a single search page. 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 If this parameter is omitted, it defaults to the descending relevance.

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.

Returns
TypeDescription
Google\Cloud\DataCatalog\V1\SearchCatalogRequest\Scope|null

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.

Parameter
NameDescription
var Google\Cloud\DataCatalog\V1\SearchCatalogRequest\Scope
Returns
TypeDescription
$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
Returns
TypeDescription
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
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getPageSize

Number of results to return in a single search page.

Can't be negative or 0, defaults to 10 in this case. The maximum number is 1000. If exceeded, throws an "invalid argument" exception.

Returns
TypeDescription
int

setPageSize

Number of results to return in a single search page.

Can't be negative or 0, defaults to 10 in this case. The maximum number is 1000. If exceeded, throws an "invalid argument" exception.

Parameter
NameDescription
var int
Returns
TypeDescription
$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.

Returns
TypeDescription
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.

Parameter
NameDescription
var string
Returns
TypeDescription
$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 If this parameter is omitted, it defaults to the descending relevance.
Returns
TypeDescription
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 If this parameter is omitted, it defaults to the descending relevance.
Parameter
NameDescription
var string
Returns
TypeDescription
$this

static::build

Parameters
NameDescription
scope Google\Cloud\DataCatalog\V1\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
Returns
TypeDescription
Google\Cloud\DataCatalog\V1\SearchCatalogRequest