diff --git a/datacatalog/samples/v1beta1/datacatalog_search.py b/datacatalog/samples/v1beta1/datacatalog_search.py new file mode 100644 index 000000000000..928b69f52fc3 --- /dev/null +++ b/datacatalog/samples/v1beta1/datacatalog_search.py @@ -0,0 +1,92 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2019 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# DO NOT EDIT! This is a generated sample ("RequestPagedAll", "datacatalog_search") + +# To install the latest published package dependency, execute the following: +# pip install google-cloud-datacatalog + +# sample-metadata +# title: +# description: Search Catalog +# usage: python3 samples/v1beta1/datacatalog_search.py [--include_project_id "[Google Cloud Project ID]"] [--include_gcp_public_datasets false] [--query "[String in search query syntax]"] +import sys + +# [START datacatalog_search] + +from google.cloud import datacatalog_v1beta1 +from google.cloud.datacatalog_v1beta1 import enums + + +def sample_search_catalog(include_project_id, include_gcp_public_datasets, query): + """ + Search Catalog + + Args: + include_project_id Your Google Cloud project ID. + include_gcp_public_datasets If true, include Google Cloud Platform (GCP) public + datasets in the search results. + query Your query string. + See: https://cloud.google.com/data-catalog/docs/how-to/search-reference + Example: system=bigquery type=dataset + """ + + client = datacatalog_v1beta1.DataCatalogClient() + + # include_project_id = '[Google Cloud Project ID]' + # include_gcp_public_datasets = False + # query = '[String in search query syntax]' + include_project_ids = [include_project_id] + scope = { + "include_project_ids": include_project_ids, + "include_gcp_public_datasets": include_gcp_public_datasets, + } + + # Iterate over all results + for response_item in client.search_catalog(scope, query): + print( + u"Result type: {}".format( + enums.SearchResultType(response_item.search_result_type).name + ) + ) + print(u"Result subtype: {}".format(response_item.search_result_subtype)) + print( + u"Relative resource name: {}".format(response_item.relative_resource_name) + ) + print(u"Linked resource: {}\n".format(response_item.linked_resource)) + + +# [END datacatalog_search] + + +def main(): + import argparse + + parser = argparse.ArgumentParser() + parser.add_argument( + "--include_project_id", type=str, default="[Google Cloud Project ID]" + ) + parser.add_argument("--include_gcp_public_datasets", type=bool, default=False) + parser.add_argument("--query", type=str, default="[String in search query syntax]") + args = parser.parse_args() + + sample_search_catalog( + args.include_project_id, args.include_gcp_public_datasets, args.query + ) + + +if __name__ == "__main__": + main() diff --git a/datacatalog/synth.metadata b/datacatalog/synth.metadata index 8cd590d7dd2c..d46534e7955d 100644 --- a/datacatalog/synth.metadata +++ b/datacatalog/synth.metadata @@ -1,19 +1,19 @@ { - "updateTime": "2019-07-20T12:17:02.340446Z", + "updateTime": "2019-07-26T12:17:03.436639Z", "sources": [ { "generator": { "name": "artman", - "version": "0.30.1", - "dockerImage": "googleapis/artman@sha256:f1a2e851e5e012c59e1da4125480bb19878f86a4e7fac4f375f2e819956b5aa3" + "version": "0.31.0", + "dockerImage": "googleapis/artman@sha256:9aed6bbde54e26d2fcde7aa86d9f64c0278f741e58808c46573e488cbf6098f0" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "184ab77f4cee62332f8f9a689c70c9bea441f836", - "internalRef": "259048326" + "sha": "0906a9e74f4db789aee7fc5016ab828d3dd24f03", + "internalRef": "260061471" } }, {