Reference documentation and code samples for the Google Cloud Data Catalog V1BETA1 API class Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest.
(::String) — Specifies the ordering of results, currently supported case-sensitive
choices are:
relevance, only supports descending
last_modified_timestamp [asc|desc], defaults to descending if not
specified
default that can only be descending
If not specified, defaults to relevance descending.
#order_by=
deforder_by=(value)->::String
Parameter
value (::String) — Specifies the ordering of results, currently supported case-sensitive
choices are:
relevance, only supports descending
last_modified_timestamp [asc|desc], defaults to descending if not
specified
default that can only be descending
If not specified, defaults to relevance descending.
Returns
(::String) — Specifies the ordering of results, currently supported case-sensitive
choices are:
relevance, only supports descending
last_modified_timestamp [asc|desc], defaults to descending if not
specified
default that can only be descending
If not specified, defaults to relevance descending.
#page_size
defpage_size()->::Integer
Returns
(::Integer) — 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.
#page_size=
defpage_size=(value)->::Integer
Parameter
value (::Integer) — 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.
Returns
(::Integer) — 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.
#page_token
defpage_token()->::String
Returns
(::String) — Optional. Pagination token returned in an earlier
SearchCatalogResponse.next_page_token,
which indicates that this is a continuation of a prior
SearchCatalogRequest
call, and that the system should return the next page of data. If empty,
the first page is returned.
#page_token=
defpage_token=(value)->::String
Parameter
value (::String) — Optional. Pagination token returned in an earlier
SearchCatalogResponse.next_page_token,
which indicates that this is a continuation of a prior
SearchCatalogRequest
call, and that the system should return the next page of data. If empty,
the first page is returned.
Returns
(::String) — Optional. Pagination token returned in an earlier
SearchCatalogResponse.next_page_token,
which indicates that this is a continuation of a prior
SearchCatalogRequest
call, and that the system should return the next page of data. If empty,
the first page is returned.
#query
defquery()->::String
Returns
(::String) — Optional. The query string in search query syntax. An empty query string
will result in all data assets (in the specified scope) that the user has
access to. Query strings can be simple as "x" or more qualified as:
name:x
column:x
description:y
Note: Query tokens need to have a minimum of 3 characters for substring
matching to work correctly. See Data Catalog Search
Syntax
for more information.
#query=
defquery=(value)->::String
Parameter
value (::String) — Optional. The query string in search query syntax. An empty query string
will result in all data assets (in the specified scope) that the user has
access to. Query strings can be simple as "x" or more qualified as:
name:x
column:x
description:y
Note: Query tokens need to have a minimum of 3 characters for substring
matching to work correctly. See Data Catalog Search
Syntax
for more information.
Returns
(::String) — Optional. The query string in search query syntax. An empty query string
will result in all data assets (in the specified scope) that the user has
access to. Query strings can be simple as "x" or more qualified as:
name:x
column:x
description:y
Note: Query tokens need to have a minimum of 3 characters for substring
matching to work correctly. See Data Catalog Search
Syntax
for more information.
(::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope) — Required. The scope of this search request. A scope that has empty
include_org_ids, include_project_ids AND false
include_gcp_public_datasets is considered invalid. Data Catalog will
return an error in such a case.
value (::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope) — Required. The scope of this search request. A scope that has empty
include_org_ids, include_project_ids AND false
include_gcp_public_datasets is considered invalid. Data Catalog will
return an error in such a case.
Returns
(::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope) — Required. The scope of this search request. A scope that has empty
include_org_ids, include_project_ids AND false
include_gcp_public_datasets is considered invalid. Data Catalog will
return an error in such a case.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-09 UTC."],[],[],null,["# Google Cloud Data Catalog V1BETA1 API - Class Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest (v0.9.1)\n\nVersion latestkeyboard_arrow_down\n\n- [0.9.1 (latest)](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.9.0](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.9.0/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.8.4](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.8.4/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.7.0](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.7.0/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.6.0](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.6.0/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.5.2](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.5.2/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.4.0](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.4.0/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.3.2](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.3.2/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.2.1](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.2.1/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest)\n- [0.1.1](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/0.1.1/Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest) \nReference documentation and code samples for the Google Cloud Data Catalog V1BETA1 API class Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest.\n\nRequest message for\n[SearchCatalog](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-DataCatalog-Client#Google__Cloud__DataCatalog__V1beta1__DataCatalog__Client_search_catalog_instance_ \"Google::Cloud::DataCatalog::V1beta1::DataCatalog::Client#search_catalog (method)\"). \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #order_by\n\n def order_by() -\u003e ::String\n\n**Returns**\n\n- (::String) --- Specifies the ordering of results, currently supported case-sensitive choices are:\n\n - `relevance`, only supports descending\n - `last_modified_timestamp [asc|desc]`, defaults to descending if not specified\n - `default` that can only be descending\n\n If not specified, defaults to `relevance` descending.\n\n### #order_by=\n\n def order_by=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- Specifies the ordering of results, currently supported case-sensitive choices are:\n\n\n - `relevance`, only supports descending\n - `last_modified_timestamp [asc|desc]`, defaults to descending if not specified\n - `default` that can only be descending\n\nIf not specified, defaults to `relevance` descending. \n**Returns**\n\n- (::String) --- Specifies the ordering of results, currently supported case-sensitive choices are:\n\n - `relevance`, only supports descending\n - `last_modified_timestamp [asc|desc]`, defaults to descending if not specified\n - `default` that can only be descending\n\n If not specified, defaults to `relevance` descending.\n\n### #page_size\n\n def page_size() -\u003e ::Integer\n\n**Returns**\n\n- (::Integer) --- Number of results in the search page. If \\\u003c=0 then defaults to 10. Max limit for page_size is 1000. Throws an invalid argument for page_size \\\u003e 1000.\n\n### #page_size=\n\n def page_size=(value) -\u003e ::Integer\n\n**Parameter**\n\n- **value** (::Integer) --- Number of results in the search page. If \\\u003c=0 then defaults to 10. Max limit for page_size is 1000. Throws an invalid argument for page_size \\\u003e 1000. \n**Returns**\n\n- (::Integer) --- Number of results in the search page. If \\\u003c=0 then defaults to 10. Max limit for page_size is 1000. Throws an invalid argument for page_size \\\u003e 1000.\n\n### #page_token\n\n def page_token() -\u003e ::String\n\n**Returns**\n\n- (::String) --- Optional. Pagination token returned in an earlier [SearchCatalogResponse.next_page_token](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-SearchCatalogResponse#Google__Cloud__DataCatalog__V1beta1__SearchCatalogResponse_next_page_token_instance_ \"Google::Cloud::DataCatalog::V1beta1::SearchCatalogResponse#next_page_token (method)\"), which indicates that this is a continuation of a prior [SearchCatalogRequest](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-DataCatalog-Client#Google__Cloud__DataCatalog__V1beta1__DataCatalog__Client_search_catalog_instance_ \"Google::Cloud::DataCatalog::V1beta1::DataCatalog::Client#search_catalog (method)\") call, and that the system should return the next page of data. If empty, the first page is returned.\n\n### #page_token=\n\n def page_token=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- Optional. Pagination token returned in an earlier [SearchCatalogResponse.next_page_token](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-SearchCatalogResponse#Google__Cloud__DataCatalog__V1beta1__SearchCatalogResponse_next_page_token_instance_ \"Google::Cloud::DataCatalog::V1beta1::SearchCatalogResponse#next_page_token (method)\"), which indicates that this is a continuation of a prior [SearchCatalogRequest](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-DataCatalog-Client#Google__Cloud__DataCatalog__V1beta1__DataCatalog__Client_search_catalog_instance_ \"Google::Cloud::DataCatalog::V1beta1::DataCatalog::Client#search_catalog (method)\") call, and that the system should return the next page of data. If empty, the first page is returned. \n**Returns**\n\n- (::String) --- Optional. Pagination token returned in an earlier [SearchCatalogResponse.next_page_token](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-SearchCatalogResponse#Google__Cloud__DataCatalog__V1beta1__SearchCatalogResponse_next_page_token_instance_ \"Google::Cloud::DataCatalog::V1beta1::SearchCatalogResponse#next_page_token (method)\"), which indicates that this is a continuation of a prior [SearchCatalogRequest](/ruby/docs/reference/google-cloud-data_catalog-v1beta1/latest/Google-Cloud-DataCatalog-V1beta1-DataCatalog-Client#Google__Cloud__DataCatalog__V1beta1__DataCatalog__Client_search_catalog_instance_ \"Google::Cloud::DataCatalog::V1beta1::DataCatalog::Client#search_catalog (method)\") call, and that the system should return the next page of data. If empty, the first page is returned.\n\n### #query\n\n def query() -\u003e ::String\n\n**Returns**\n\n- (::String) --- Optional. The query string in search query syntax. An empty query string will result in all data assets (in the specified scope) that the user has access to. Query strings can be simple as \"x\" or more qualified as:\n\n - name:x\n - column:x\n - description:y\n\n Note: Query tokens need to have a minimum of 3 characters for substring\n matching to work correctly. See [Data Catalog Search\n Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)\n for more information.\n\n### #query=\n\n def query=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- Optional. The query string in search query syntax. An empty query string will result in all data assets (in the specified scope) that the user has access to. Query strings can be simple as \"x\" or more qualified as:\n\n\n - name:x\n - column:x\n - description:y\n\n Note: Query tokens need to have a minimum of 3 characters for substring\n matching to work correctly. See [Data Catalog Search\n Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)\nfor more information. \n**Returns**\n\n- (::String) --- Optional. The query string in search query syntax. An empty query string will result in all data assets (in the specified scope) that the user has access to. Query strings can be simple as \"x\" or more qualified as:\n\n - name:x\n - column:x\n - description:y\n\n Note: Query tokens need to have a minimum of 3 characters for substring\n matching to work correctly. See [Data Catalog Search\n Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)\n for more information.\n\n### #scope\n\n def scope() -\u003e ::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope\n\n**Returns**\n\n- ([::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope](./Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest-Scope)) --- Required. The scope of this search request. A `scope` that has empty `include_org_ids`, `include_project_ids` AND false `include_gcp_public_datasets` is considered invalid. Data Catalog will return an error in such a case.\n\n### #scope=\n\n def scope=(value) -\u003e ::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope\n\n**Parameter**\n\n- **value** ([::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope](./Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest-Scope)) --- Required. The scope of this search request. A `scope` that has empty `include_org_ids`, `include_project_ids` AND false `include_gcp_public_datasets` is considered invalid. Data Catalog will return an error in such a case. \n**Returns**\n\n- ([::Google::Cloud::DataCatalog::V1beta1::SearchCatalogRequest::Scope](./Google-Cloud-DataCatalog-V1beta1-SearchCatalogRequest-Scope)) --- Required. The scope of this search request. A `scope` that has empty `include_org_ids`, `include_project_ids` AND false `include_gcp_public_datasets` is considered invalid. Data Catalog will return an error in such a case."]]