google-cloud-data_catalog-v1 0.16.1 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28bf630d534794238c253df00f1dbf9b82357d941b98c2688fe8b67655c63c8a
-  data.tar.gz: 5f990c62a7ce46831e25564615b90cba47c7a918032cceb947078acaefaa4b01
+  metadata.gz: 3f112b90d3b5aa7893c9c64c80f1bb6479b8a6e134341c94f1f623716b32a558
+  data.tar.gz: 2668136915f29f48459da536df8c35a5bdf4c9fbfbe59995dc07ad967a0108a2
 SHA512:
-  metadata.gz: 49ad8a5f5a98fb81113b4dc50350f5e9f8f47eabf0aac63db5cada8bb303ceaa3db01b93e2875254a823dc11cb12888b7ac28f2fd9efce8c1f944c2d41deaee0
-  data.tar.gz: 3735bb02ab975e35e07bf448870e037fe94340049652d7931072f47b61f4414b57da0f968f60de193aff4a3c7a6f3dff8b35ed8c3e2e7a1e786972853adbce3c
+  metadata.gz: 2c87e7005b3fc029f094e1474d1a665f2e40bbe1bcb6be83733d0954cf47c599f892f693835c6b26ca529f5ab5c5a08df7cfaac60bf532f063f7556a801b4c06
+  data.tar.gz: 699b09da4e5eb4c18ffc43cdc58d61d1a7409ff018b8263258aa819fedc751caea3c244ea35c322192bb8a52df1e229a62034a434d78a49a4d5b05f919b6c5d2

data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb

@@ -229,7 +229,7 @@ module Google
             #     * `column:y`
             #     * `description:z`
             #   @param page_size [::Integer]
-            #     Number of results to return in a single search page.
+            #     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"
@@ -252,6 +252,13 @@ module Google
             #     * `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`.
             #
             # @yield [response, operation] Access the result along with the RPC operation

data/lib/google/cloud/data_catalog/v1/data_catalog/rest/client.rb

@@ -220,7 +220,7 @@ module Google
               #     * `column:y`
               #     * `description:z`
               #   @param page_size [::Integer]
-              #     Number of results to return in a single search page.
+              #     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"
@@ -243,6 +243,13 @@ module Google
               #     * `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`.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DataCatalog::V1::SearchCatalogResponse]

data/lib/google/cloud/data_catalog/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module DataCatalog
       module V1
-        VERSION = "0.16.1"
+        VERSION = "0.17.0"
       end
     end
   end

data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb

@@ -46,7 +46,7 @@ module Google
         #     * `description:z`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Number of results to return in a single search page.
+        #     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"
@@ -71,6 +71,13 @@ module Google
         #     * `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`.
         class SearchCatalogRequest
           include ::Google::Protobuf::MessageExts
@@ -443,10 +450,8 @@ module Google
         # @!attribute [rw] type
         #   @return [::Google::Cloud::DataCatalog::V1::EntryType]
         #     The type of the entry.
-        #     Only used for entries with types listed in the `EntryType` enum.
         #
-        #     Currently, only `FILESET` enum value is allowed. All other entries
-        #     created in Data Catalog must use the `user_specified_type`.
+        #     For details, see [`EntryType`](#entrytype).
         # @!attribute [rw] user_specified_type
         #   @return [::String]
         #     Custom entry type that doesn't match any of the values allowed for input
@@ -1423,8 +1428,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The enum field that lists all the types of entry resources in Data
-        # Catalog. For example, a BigQuery table entry has the `TABLE` type.
+        # Metadata automatically ingested from Google Cloud resources like BigQuery
+        # tables or Pub/Sub topics always uses enum values from `EntryType` as the type
+        # of entry.
+        #
+        # Other sources of metadata like Hive or Oracle databases can identify the type
+        # by either using one of the enum values from `EntryType` (for example,
+        # `FILESET` for a Cloud Storage fileset) or specifying a custom value using
+        # the [`Entry`](#resource:-entry) field `user_specified_type`. For more
+        # information, see
+        # [Surface files from Cloud Storage with fileset
+        # entries](/data-catalog/docs/how-to/filesets) or [Create custom entries for
+        # your data sources](/data-catalog/docs/how-to/custom-entries).
         module EntryType
           # Default unknown type.
           ENTRY_TYPE_UNSPECIFIED = 0
@@ -1433,10 +1448,10 @@ module Google
           # logical views.
           TABLE = 2
 
-          # Output only. The type of models.
+          # The type of models.
           #
-          # For more information, see [Supported models in BigQuery ML]
-          # (https://cloud.google.com/bigquery-ml/docs/introduction#supported_models_in).
+          # For more information, see [Supported models in BigQuery
+          # ML](/bigquery/docs/bqml-introduction#supported_models).
           MODEL = 5
 
           # An entry type for streaming entries. For example, a Pub/Sub topic.
@@ -1452,11 +1467,11 @@ module Google
           # A database.
           DATABASE = 7
 
-          # Output only. Connection to a data source. For example, a BigQuery
+          # Connection to a data source. For example, a BigQuery
           # connection.
           DATA_SOURCE_CONNECTION = 8
 
-          # Output only. Routine, for example, a BigQuery routine.
+          # Routine, for example, a BigQuery routine.
           ROUTINE = 9
 
           # A Dataplex lake.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-data_catalog-v1
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 0.17.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-06 00:00:00.000000000 Z
+date: 2023-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common