google-apis-datastream_v1 0.26.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b43a9df4db31e1c91a8df4272c64c3046fd343c1e24f95e8605047d9b627e8a6
-  data.tar.gz: 109d3a9f8334ff7f3f06a9ef10d1a6e419d01d6c7506833f1c8791ef2e021438
+  metadata.gz: 3119f9d8d60fc7ce2f08bcd35c0f7a32ff315396e9230b034cfb429be80ad355
+  data.tar.gz: eb32c51c1e272eec57aa62679fca19c380f7c333317e2d9779f6445685612959
 SHA512:
-  metadata.gz: 2a884029ebf8e46ed53a2c5fc9da775507b56eec96b4009ef01d858853f3192a5037e4237306d2af50a2eae3e2d8f68eb69302102afa3919db427a75eb22caaa
-  data.tar.gz: 0a0864bca9977df56d4894713d23e1da8ae028cedd4d93d96041b2197c4c68e519251d19b2651a049de542a1def2f052880361929ed67464e4182e56ae45611c
+  metadata.gz: 2c8cfa1657373861688067de493161abdcee3e604b3cff092c39fd2309b0a5a6cfd7c1070200e62d9539d7a6b029eaa4a8b00e2c900ac5c94f8585afd0d4ec4e
+  data.tar.gz: c4661cd48e430990192c05d704dd64121cb3acbcc548bda8762f1f9e9fb6b48aa24e884ae8c82f8fbbacfbf2788d80626e1596be94fb0bff7abe11f0c32d0f22

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-datastream_v1
 
+### v0.28.0 (2023-08-03)
+
+* Regenerated from discovery document revision 20230719
+
+### v0.27.0 (2023-07-23)
+
+* Regenerated from discovery document revision 20230630
+
 ### v0.26.0 (2023-06-25)
 
 * Regenerated from discovery document revision 20230611

data/lib/google/apis/datastream_v1/classes.rb

@@ -184,6 +184,38 @@ module Google
         end
       end
       
+      # The strategy that the stream uses for CDC replication.
+      class CdcStrategy
+        include Google::Apis::Core::Hashable
+      
+        # CDC strategy to start replicating from the most recent position in the source.
+        # Corresponds to the JSON property `mostRecentStartPosition`
+        # @return [Google::Apis::DatastreamV1::MostRecentStartPosition]
+        attr_accessor :most_recent_start_position
+      
+        # CDC strategy to resume replication from the next available position in the
+        # source.
+        # Corresponds to the JSON property `nextAvailableStartPosition`
+        # @return [Google::Apis::DatastreamV1::NextAvailableStartPosition]
+        attr_accessor :next_available_start_position
+      
+        # CDC strategy to start replicating from a specific position in the source.
+        # Corresponds to the JSON property `specificStartPosition`
+        # @return [Google::Apis::DatastreamV1::SpecificStartPosition]
+        attr_accessor :specific_start_position
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @most_recent_start_position = args[:most_recent_start_position] if args.key?(:most_recent_start_position)
+          @next_available_start_position = args[:next_available_start_position] if args.key?(:next_available_start_position)
+          @specific_start_position = args[:specific_start_position] if args.key?(:specific_start_position)
+        end
+      end
+      
       # A set of reusable connection configurations to be used as a source or
       # destination for a stream.
       class ConnectionProfile
@@ -944,6 +976,19 @@ module Google
         end
       end
       
+      # CDC strategy to start replicating from the most recent position in the source.
+      class MostRecentStartPosition
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # MySQL Column.
       class MysqlColumn
         include Google::Apis::Core::Hashable
@@ -980,12 +1025,22 @@ module Google
         # @return [Fixnum]
         attr_accessor :ordinal_position
       
+        # Column precision.
+        # Corresponds to the JSON property `precision`
+        # @return [Fixnum]
+        attr_accessor :precision
+      
         # Whether or not the column represents a primary key.
         # Corresponds to the JSON property `primaryKey`
         # @return [Boolean]
         attr_accessor :primary_key
         alias_method :primary_key?, :primary_key
       
+        # Column scale.
+        # Corresponds to the JSON property `scale`
+        # @return [Fixnum]
+        attr_accessor :scale
+      
         def initialize(**args)
            update!(**args)
         end
@@ -998,7 +1053,9 @@ module Google
           @length = args[:length] if args.key?(:length)
           @nullable = args[:nullable] if args.key?(:nullable)
           @ordinal_position = args[:ordinal_position] if args.key?(:ordinal_position)
+          @precision = args[:precision] if args.key?(:precision)
           @primary_key = args[:primary_key] if args.key?(:primary_key)
+          @scale = args[:scale] if args.key?(:scale)
         end
       end
       
@@ -1027,6 +1084,31 @@ module Google
         end
       end
       
+      # MySQL log position
+      class MysqlLogPosition
+        include Google::Apis::Core::Hashable
+      
+        # The binary log file name.
+        # Corresponds to the JSON property `logFile`
+        # @return [String]
+        attr_accessor :log_file
+      
+        # The position within the binary log file. Default is head of file.
+        # Corresponds to the JSON property `logPosition`
+        # @return [Fixnum]
+        attr_accessor :log_position
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @log_file = args[:log_file] if args.key?(:log_file)
+          @log_position = args[:log_position] if args.key?(:log_position)
+        end
+      end
+      
       # Mysql data source object identifier.
       class MysqlObjectIdentifier
         include Google::Apis::Core::Hashable
@@ -1236,6 +1318,20 @@ module Google
         end
       end
       
+      # CDC strategy to resume replication from the next available position in the
+      # source.
+      class NextAvailableStartPosition
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation
@@ -2013,6 +2109,25 @@ module Google
         end
       end
       
+      # Request message for running a stream.
+      class RunStreamRequest
+        include Google::Apis::Core::Hashable
+      
+        # The strategy that the stream uses for CDC replication.
+        # Corresponds to the JSON property `cdcStrategy`
+        # @return [Google::Apis::DatastreamV1::CdcStrategy]
+        attr_accessor :cdc_strategy
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cdc_strategy = args[:cdc_strategy] if args.key?(:cdc_strategy)
+        end
+      end
+      
       # A single target dataset to which all data will be streamed.
       class SingleTargetDataset
         include Google::Apis::Core::Hashable
@@ -2122,6 +2237,25 @@ module Google
         end
       end
       
+      # CDC strategy to start replicating from a specific position in the source.
+      class SpecificStartPosition
+        include Google::Apis::Core::Hashable
+      
+        # MySQL log position
+        # Corresponds to the JSON property `mysqlLogPosition`
+        # @return [Google::Apis::DatastreamV1::MysqlLogPosition]
+        attr_accessor :mysql_log_position
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mysql_log_position = args[:mysql_log_position] if args.key?(:mysql_log_position)
+        end
+      end
+      
       # Request for manually initiating a backfill job for a specific stream object.
       class StartBackfillJobRequest
         include Google::Apis::Core::Hashable

data/lib/google/apis/datastream_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DatastreamV1
       # Version of the google-apis-datastream_v1 gem
-      GEM_VERSION = "0.26.0"
+      GEM_VERSION = "0.28.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230611"
+      REVISION = "20230719"
     end
   end
 end

data/lib/google/apis/datastream_v1/representations.rb

@@ -64,6 +64,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CdcStrategy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ConnectionProfile
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -196,6 +202,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MostRecentStartPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MysqlColumn
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -208,6 +220,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MysqlLogPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class MysqlObjectIdentifier
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -244,6 +262,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class NextAvailableStartPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -358,6 +382,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RunStreamRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SingleTargetDataset
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -382,6 +412,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SpecificStartPosition
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class StartBackfillJobRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -519,6 +555,18 @@ module Google
         end
       end
       
+      class CdcStrategy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :most_recent_start_position, as: 'mostRecentStartPosition', class: Google::Apis::DatastreamV1::MostRecentStartPosition, decorator: Google::Apis::DatastreamV1::MostRecentStartPosition::Representation
+      
+          property :next_available_start_position, as: 'nextAvailableStartPosition', class: Google::Apis::DatastreamV1::NextAvailableStartPosition, decorator: Google::Apis::DatastreamV1::NextAvailableStartPosition::Representation
+      
+          property :specific_start_position, as: 'specificStartPosition', class: Google::Apis::DatastreamV1::SpecificStartPosition, decorator: Google::Apis::DatastreamV1::SpecificStartPosition::Representation
+      
+        end
+      end
+      
       class ConnectionProfile
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -752,6 +800,12 @@ module Google
         end
       end
       
+      class MostRecentStartPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class MysqlColumn
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -761,7 +815,9 @@ module Google
           property :length, as: 'length'
           property :nullable, as: 'nullable'
           property :ordinal_position, as: 'ordinalPosition'
+          property :precision, as: 'precision'
           property :primary_key, as: 'primaryKey'
+          property :scale, as: 'scale'
         end
       end
       
@@ -774,6 +830,14 @@ module Google
         end
       end
       
+      class MysqlLogPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :log_file, as: 'logFile'
+          property :log_position, as: 'logPosition'
+        end
+      end
+      
       class MysqlObjectIdentifier
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -835,6 +899,12 @@ module Google
         end
       end
       
+      class NextAvailableStartPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1047,6 +1117,14 @@ module Google
         end
       end
       
+      class RunStreamRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cdc_strategy, as: 'cdcStrategy', class: Google::Apis::DatastreamV1::CdcStrategy, decorator: Google::Apis::DatastreamV1::CdcStrategy::Representation
+      
+        end
+      end
+      
       class SingleTargetDataset
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1087,6 +1165,14 @@ module Google
         end
       end
       
+      class SpecificStartPosition
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :mysql_log_position, as: 'mysqlLogPosition', class: Google::Apis::DatastreamV1::MysqlLogPosition, decorator: Google::Apis::DatastreamV1::MysqlLogPosition::Representation
+      
+        end
+      end
+      
       class StartBackfillJobRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/datastream_v1/service.rb

@@ -1156,6 +1156,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Use this method to start, resume or recover a stream with a non default CDC
+        # strategy.
+        # @param [String] name
+        #   Required. Name of the stream resource to start, in the format: projects/`
+        #   project_id`/locations/`location`/streams/`stream_name`
+        # @param [Google::Apis::DatastreamV1::RunStreamRequest] run_stream_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DatastreamV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatastreamV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def run_stream(name, run_stream_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:run', options)
+          command.request_representation = Google::Apis::DatastreamV1::RunStreamRequest::Representation
+          command.request_object = run_stream_request_object
+          command.response_representation = Google::Apis::DatastreamV1::Operation::Representation
+          command.response_class = Google::Apis::DatastreamV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Use this method to get details about a stream object.
         # @param [String] name
         #   Required. The name of the stream object resource to get.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-datastream_v1
 version: !ruby/object:Gem::Version
-  version: 0.26.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-25 00:00:00.000000000 Z
+date: 2023-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datastream_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-datastream_v1/v0.26.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-datastream_v1/v0.28.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datastream_v1
 post_install_message: 
 rdoc_options: []