google-cloud-datastream-v1 0.5.0 → 0.6.0

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

@@ -24,8 +24,8 @@ module Google
         # Request message for 'discover' ConnectionProfile request.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The parent resource of the connection profile type. Must be in the
-        #     format `projects/*/locations/*`.
+        #     Required. The parent resource of the connection profile type. Must be in
+        #     the format `projects/*/locations/*`.
         # @!attribute [rw] connection_profile
         #   @return [::Google::Cloud::Datastream::V1::ConnectionProfile]
         #     An ad-hoc connection profile configuration.
@@ -71,8 +71,8 @@ module Google
         # Request message for 'FetchStaticIps' request.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The resource name for the location for which static IPs should be returned.
-        #     Must be in the format `projects/*/locations/*`.
+        #     Required. The resource name for the location for which static IPs should be
+        #     returned. Must be in the format `projects/*/locations/*`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Maximum number of Ips to return, will likely not be specified.
@@ -177,8 +177,8 @@ module Google
         #     not supported (00000000-0000-0000-0000-000000000000).
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the connection profile, but don't create any resources.
-        #     The default is false.
+        #     Optional. Only validate the connection profile, but don't create any
+        #     resources. The default is false.
         # @!attribute [rw] force
         #   @return [::Boolean]
         #     Optional. Create the connection profile without validating it.
@@ -215,8 +215,8 @@ module Google
         #     not supported (00000000-0000-0000-0000-000000000000).
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the connection profile, but don't update any resources.
-        #     The default is false.
+        #     Optional. Only validate the connection profile, but don't update any
+        #     resources. The default is false.
         # @!attribute [rw] force
         #   @return [::Boolean]
         #     Optional. Update the connection profile without validating it.
@@ -366,8 +366,8 @@ module Google
         #     not supported (00000000-0000-0000-0000-000000000000).
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the stream with the changes, without actually updating it.
-        #     The default is false.
+        #     Optional. Only validate the stream with the changes, without actually
+        #     updating it. The default is false.
         # @!attribute [rw] force
         #   @return [::Boolean]
         #     Optional. Update the stream without validating it.
@@ -425,7 +425,8 @@ module Google
         # Request for manually initiating a backfill job for a specific stream object.
         # @!attribute [rw] object
         #   @return [::String]
-        #     Required. The name of the stream object resource to start a backfill job for.
+        #     Required. The name of the stream object resource to start a backfill job
+        #     for.
         class StartBackfillJobRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -444,7 +445,8 @@ module Google
         # object.
         # @!attribute [rw] object
         #   @return [::String]
-        #     Required. The name of the stream object resource to stop the backfill job for.
+        #     Required. The name of the stream object resource to stop the backfill job
+        #     for.
         class StopBackfillJobRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -512,8 +514,9 @@ module Google
         #   @return [::Boolean]
         #     Output only. Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
-        #     have [Operation.error][] value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-        #     corresponding to `Code.CANCELLED`.
+        #     have [Operation.error][] value with a
+        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
+        #     `Code.CANCELLED`.
         # @!attribute [r] api_version
         #   @return [::String]
         #     Output only. API version used to start the operation.
@@ -550,6 +553,9 @@ module Google
         #
         #     The request ID must be a valid UUID with the exception that zero UUID is
         #     not supported (00000000-0000-0000-0000-000000000000).
+        # @!attribute [rw] force
+        #   @return [::Boolean]
+        #     Optional. If set to true, will skip validations.
         class CreatePrivateConnectionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -558,7 +564,8 @@ module Google
         # Request for listing private connections.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The parent that owns the collection of private connectivity configurations.
+        #     Required. The parent that owns the collection of private connectivity
+        #     configurations.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Maximum number of private connectivity configurations to return.
@@ -621,8 +628,8 @@ module Google
         #     not supported (00000000-0000-0000-0000-000000000000).
         # @!attribute [rw] force
         #   @return [::Boolean]
-        #     Optional. If set to true, any child routes that belong to this PrivateConnection will
-        #     also be deleted.
+        #     Optional. If set to true, any child routes that belong to this
+        #     PrivateConnection will also be deleted.
         class DeletePrivateConnectionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/datastream/v1/datastream_resources.rb

@@ -114,7 +114,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Static IP address connectivity.
+        # Static IP address connectivity. Used when the source database is configured
+        # to allow incoming connections from the Datastream public IP addresses
+        # for the region specified in the connection profile.
         class StaticServiceIpConnectivity
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -177,7 +179,8 @@ module Google
         #     Output only. The state of the Private Connection.
         # @!attribute [r] error
         #   @return [::Google::Cloud::Datastream::V1::Error]
-        #     Output only. In case of error, the details of the error in a user-friendly format.
+        #     Output only. In case of error, the details of the error in a user-friendly
+        #     format.
         # @!attribute [rw] vpc_peering_config
         #   @return [::Google::Cloud::Datastream::V1::VpcPeeringConfig]
         #     VPC Peering Config.
@@ -282,8 +285,8 @@ module Google
         #     Output only. Indicates whether the client_certificate field is set.
         # @!attribute [rw] ca_certificate
         #   @return [::String]
-        #     Input only. PEM-encoded certificate of the CA that signed the source database
-        #     server's certificate.
+        #     Input only. PEM-encoded certificate of the CA that signed the source
+        #     database server's certificate.
         # @!attribute [r] ca_certificate_set
         #   @return [::Boolean]
         #     Output only. Indicates whether the ca_certificate field is set.
@@ -424,14 +427,18 @@ module Google
         #     Oracle objects to exclude from the stream.
         # @!attribute [rw] max_concurrent_cdc_tasks
         #   @return [::Integer]
-        #     Maximum number of concurrent CDC tasks. The number should be non negative.
-        #     If not set (or set to 0), the system's default value will be used.
+        #     Maximum number of concurrent CDC tasks. The number should be non-negative.
+        #     If not set (or set to 0), the system's default value is used.
+        # @!attribute [rw] max_concurrent_backfill_tasks
+        #   @return [::Integer]
+        #     Maximum number of concurrent backfill tasks. The number should be
+        #     non-negative. If not set (or set to 0), the system's default value is used.
         # @!attribute [rw] drop_large_objects
         #   @return [::Google::Cloud::Datastream::V1::OracleSourceConfig::DropLargeObjects]
         #     Drop large object values.
         # @!attribute [rw] stream_large_objects
         #   @return [::Google::Cloud::Datastream::V1::OracleSourceConfig::StreamLargeObjects]
-        #     Stream large object values.
+        #     Stream large object values. NOTE: This feature is currently experimental.
         class OracleSourceConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -523,12 +530,17 @@ module Google
         #     PostgreSQL objects to exclude from the stream.
         # @!attribute [rw] replication_slot
         #   @return [::String]
-        #     Required. The name of the logical replication slot that's configured with the
-        #     pgoutput plugin.
+        #     Required. Immutable. The name of the logical replication slot that's
+        #     configured with the pgoutput plugin.
         # @!attribute [rw] publication
         #   @return [::String]
-        #     Required. The name of the publication that includes the set of all tables that are
-        #     defined in the stream's include_objects.
+        #     Required. The name of the publication that includes the set of all tables
+        #     that are defined in the stream's include_objects.
+        # @!attribute [rw] max_concurrent_backfill_tasks
+        #   @return [::Integer]
+        #     Maximum number of concurrent backfill tasks. The number should be non
+        #     negative. If not set (or set to 0), the system's default value will be
+        #     used.
         class PostgresqlSourceConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -608,6 +620,11 @@ module Google
         #   @return [::Integer]
         #     Maximum number of concurrent CDC tasks. The number should be non negative.
         #     If not set (or set to 0), the system's default value will be used.
+        # @!attribute [rw] max_concurrent_backfill_tasks
+        #   @return [::Integer]
+        #     Maximum number of concurrent backfill tasks. The number should be non
+        #     negative. If not set (or set to 0), the system's default value will be
+        #     used.
         class MysqlSourceConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -684,7 +701,8 @@ module Google
         # @!attribute [rw] file_rotation_interval
         #   @return [::Google::Protobuf::Duration]
         #     The maximum duration for which new events are added before a file is
-        #     closed and a new file is created.
+        #     closed and a new file is created. Values within the range of 15-60 seconds
+        #     are allowed.
         # @!attribute [rw] avro_file_format
         #   @return [::Google::Cloud::Datastream::V1::AvroFileFormat]
         #     AVRO file format configuration.
@@ -696,6 +714,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # BigQuery destination configuration
         # @!attribute [rw] single_target_dataset
         #   @return [::Google::Cloud::Datastream::V1::BigQueryDestinationConfig::SingleTargetDataset]
         #     Single destination dataset.
@@ -715,6 +734,7 @@ module Google
           # A single target dataset to which all data will be streamed.
           # @!attribute [rw] dataset_id
           #   @return [::String]
+          #     The dataset ID of the target dataset.
           class SingleTargetDataset
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -724,6 +744,7 @@ module Google
           # objects matches the source hierarchy.
           # @!attribute [rw] dataset_template
           #   @return [::Google::Cloud::Datastream::V1::BigQueryDestinationConfig::SourceHierarchyDatasets::DatasetTemplate]
+          #     The dataset template to use for dynamic dataset creation.
           class SourceHierarchyDatasets
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    # Example 4: Pack and unpack a message in Go
+    #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # JSON
-    #
+    # ====
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-datastream-v1
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-08 00:00:00.000000000 Z
+date: 2023-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a