google-cloud-bigquery-migration-v2 0.10.0 → 0.11.0

data/lib/google/cloud/bigquery/migration/v2/translation_details_pb.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/migration/v2/translation_details.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+
+
+descriptor_data = "\n<google/cloud/bigquery/migration/v2/translation_details.proto\x12\"google.cloud.bigquery.migration.v2\x1a\x1fgoogle/api/field_behavior.proto\"\x8e\x02\n\x12TranslationDetails\x12V\n\x15source_target_mapping\x18\x01 \x03(\x0b\x32\x37.google.cloud.bigquery.migration.v2.SourceTargetMapping\x12\x17\n\x0ftarget_base_uri\x18\x02 \x01(\t\x12Q\n\x12source_environment\x18\x03 \x01(\x0b\x32\x35.google.cloud.bigquery.migration.v2.SourceEnvironment\x12\x1e\n\x16target_return_literals\x18\x04 \x03(\t\x12\x14\n\x0ctarget_types\x18\x05 \x03(\t\"\x9f\x01\n\x13SourceTargetMapping\x12\x43\n\x0bsource_spec\x18\x01 \x01(\x0b\x32..google.cloud.bigquery.migration.v2.SourceSpec\x12\x43\n\x0btarget_spec\x18\x02 \x01(\x0b\x32..google.cloud.bigquery.migration.v2.TargetSpec\"\x81\x01\n\nSourceSpec\x12\x12\n\x08\x62\x61se_uri\x18\x01 \x01(\tH\x00\x12>\n\x07literal\x18\x02 \x01(\x0b\x32+.google.cloud.bigquery.migration.v2.LiteralH\x00\x12\x15\n\x08\x65ncoding\x18\x03 \x01(\tB\x03\xe0\x41\x01\x42\x08\n\x06source\"#\n\nTargetSpec\x12\x15\n\rrelative_path\x18\x01 \x01(\t\"h\n\x07Literal\x12\x18\n\x0eliteral_string\x18\x02 \x01(\tH\x00\x12\x17\n\rliteral_bytes\x18\x03 \x01(\x0cH\x00\x12\x1a\n\rrelative_path\x18\x01 \x01(\tB\x03\xe0\x41\x02\x42\x0e\n\x0cliteral_data\"n\n\x11SourceEnvironment\x12\x18\n\x10\x64\x65\x66\x61ult_database\x18\x01 \x01(\t\x12\x1a\n\x12schema_search_path\x18\x02 \x03(\t\x12#\n\x16metadata_store_dataset\x18\x03 \x01(\tB\x03\xe0\x41\x01\x42\xd3\x01\n&com.google.cloud.bigquery.migration.v2B\x17TranslationDetailsProtoP\x01ZDcloud.google.com/go/bigquery/migration/apiv2/migrationpb;migrationpb\xaa\x02\"Google.Cloud.BigQuery.Migration.V2\xca\x02\"Google\\Cloud\\BigQuery\\Migration\\V2b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module Bigquery
+      module Migration
+        module V2
+          TranslationDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.TranslationDetails").msgclass
+          SourceTargetMapping = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.SourceTargetMapping").msgclass
+          SourceSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.SourceSpec").msgclass
+          TargetSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.TargetSpec").msgclass
+          Literal = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.Literal").msgclass
+          SourceEnvironment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.SourceEnvironment").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigquery/migration/v2/translation_suggestion_pb.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/migration/v2/translation_suggestion.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+
+
+descriptor_data = "\n?google/cloud/bigquery/migration/v2/translation_suggestion.proto\x12\"google.cloud.bigquery.migration.v2\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\"\x88\x02\n\x17TranslationReportRecord\x12V\n\x08severity\x18\x01 \x01(\x0e\x32\x44.google.cloud.bigquery.migration.v2.TranslationReportRecord.Severity\x12\x13\n\x0bscript_line\x18\x02 \x01(\x05\x12\x15\n\rscript_column\x18\x03 \x01(\x05\x12\x10\n\x08\x63\x61tegory\x18\x04 \x01(\t\x12\x0f\n\x07message\x18\x05 \x01(\t\"F\n\x08Severity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\x42\xd6\x01\n&com.google.cloud.bigquery.migration.v2B\x1aTranslationSuggestionProtoP\x01ZDcloud.google.com/go/bigquery/migration/apiv2/migrationpb;migrationpb\xaa\x02\"Google.Cloud.BigQuery.Migration.V2\xca\x02\"Google\\Cloud\\BigQuery\\Migration\\V2b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module Bigquery
+      module Migration
+        module V2
+          TranslationReportRecord = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.TranslationReportRecord").msgclass
+          TranslationReportRecord::Severity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.TranslationReportRecord.Severity").enummodule
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigquery/migration/v2/translation_usability_pb.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/migration/v2/translation_usability.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+
+
+descriptor_data = "\n>google/cloud/bigquery/migration/v2/translation_usability.proto\x12\"google.cloud.bigquery.migration.v2\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\"\xf6\x01\n\x13GcsReportLogMessage\x12\x10\n\x08severity\x18\x01 \x01(\t\x12\x10\n\x08\x63\x61tegory\x18\x02 \x01(\t\x12\x11\n\tfile_path\x18\x03 \x01(\t\x12\x10\n\x08\x66ilename\x18\x04 \x01(\t\x12\x1a\n\x12source_script_line\x18\x05 \x01(\x05\x12\x1c\n\x14source_script_column\x18\x06 \x01(\x05\x12\x0f\n\x07message\x18\x07 \x01(\t\x12\x16\n\x0escript_context\x18\x08 \x01(\t\x12\x0e\n\x06\x61\x63tion\x18\t \x01(\t\x12\x0e\n\x06\x65\x66\x66\x65\x63t\x18\n \x01(\t\x12\x13\n\x0bobject_name\x18\x0b \x01(\tB\xd5\x01\n&com.google.cloud.bigquery.migration.v2B\x19TranslationUsabilityProtoP\x01ZDcloud.google.com/go/bigquery/migration/apiv2/migrationpb;migrationpb\xaa\x02\"Google.Cloud.BigQuery.Migration.V2\xca\x02\"Google\\Cloud\\BigQuery\\Migration\\V2b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Cloud
+    module Bigquery
+      module Migration
+        module V2
+          GcsReportLogMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.migration.v2.GcsReportLogMessage").msgclass
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigquery/migration/v2/version.rb

@@ -22,7 +22,7 @@ module Google
     module Bigquery
       module Migration
         module V2
-          VERSION = "0.10.0"
+          VERSION = "0.11.0"
         end
       end
     end

data/lib/google/cloud/bigquery/migration/v2.rb

@@ -31,6 +31,11 @@ module Google
         #     require "google/cloud/bigquery/migration/v2"
         #     client = ::Google::Cloud::Bigquery::Migration::V2::MigrationService::Client.new
         #
+        # @example Load this package, including all its services, and instantiate a REST client
+        #
+        #     require "google/cloud/bigquery/migration/v2"
+        #     client = ::Google::Cloud::Bigquery::Migration::V2::MigrationService::Rest::Client.new
+        #
         module V2
         end
       end

data/proto_docs/google/api/client.rb

@@ -118,6 +118,10 @@ module Google
     #   @return [::String]
     #     Optional link to proto reference documentation.  Example:
     #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
+    # @!attribute [rw] rest_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to REST reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rest
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -286,6 +290,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -294,17 +305,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -313,8 +321,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See

data/proto_docs/google/cloud/bigquery/migration/v2/migration_entities.rb

@@ -26,8 +26,8 @@ module Google
           # migration.
           # @!attribute [r] name
           #   @return [::String]
-          #     Output only. Immutable. The unique identifier for the migration workflow.
-          #     The ID is server-generated.
+          #     Output only. Immutable. Identifier. The unique identifier for the migration
+          #     workflow. The ID is server-generated.
           #
           #     Example: `projects/123/locations/us/workflows/345`
           # @!attribute [rw] display_name
@@ -88,7 +88,10 @@ module Google
           # the task.
           # @!attribute [rw] translation_config_details
           #   @return [::Google::Cloud::Bigquery::Migration::V2::TranslationConfigDetails]
-          #     Task configuration for Batch SQL Translation.
+          #     Task configuration for CW Batch/Offline SQL Translation.
+          # @!attribute [rw] translation_details
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::TranslationDetails]
+          #     Task details for unified SQL Translation.
           # @!attribute [r] id
           #   @return [::String]
           #     Output only. Immutable. The unique identifier for the migration task. The
@@ -101,7 +104,7 @@ module Google
           #     Translation_Snowflake2BQ, Translation_Netezza2BQ,
           #     Translation_AzureSynapse2BQ, Translation_Vertica2BQ,
           #     Translation_SQLServer2BQ, Translation_Presto2BQ, Translation_MySQL2BQ,
-          #     Translation_Postgresql2BQ.
+          #     Translation_Postgresql2BQ, Translation_SQLite2BQ, Translation_Greenplum2BQ.
           # @!attribute [r] state
           #   @return [::Google::Cloud::Bigquery::Migration::V2::MigrationTask::State]
           #     Output only. The current state of the task.
@@ -115,6 +118,29 @@ module Google
           # @!attribute [rw] last_update_time
           #   @return [::Google::Protobuf::Timestamp]
           #     Time when the task was last updated.
+          # @!attribute [r] resource_error_details
+          #   @return [::Array<::Google::Cloud::Bigquery::Migration::V2::ResourceErrorDetail>]
+          #     Output only. Provides details to errors and issues encountered while
+          #     processing the task. Presence of error details does not mean that the task
+          #     failed.
+          # @!attribute [rw] resource_error_count
+          #   @return [::Integer]
+          #     The number or resources with errors. Note: This is not the total
+          #     number of errors as each resource can have more than one error.
+          #     This is used to indicate truncation by having a `resource_error_count`
+          #     that is higher than the size of `resource_error_details`.
+          # @!attribute [rw] metrics
+          #   @return [::Array<::Google::Cloud::Bigquery::Migration::V2::TimeSeries>]
+          #     The metrics for the task.
+          # @!attribute [r] task_result
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::MigrationTaskResult]
+          #     Output only. The result of the task.
+          # @!attribute [rw] total_processing_error_count
+          #   @return [::Integer]
+          #     Count of all the processing errors in this task and its subtasks.
+          # @!attribute [rw] total_resource_error_count
+          #   @return [::Integer]
+          #     Count of all the resource errors in this task and its subtasks.
           class MigrationTask
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -220,6 +246,27 @@ module Google
               PENDING_DEPENDENCY = 6
             end
           end
+
+          # The migration task result.
+          # @!attribute [rw] translation_task_result
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::TranslationTaskResult]
+          #     Details specific to translation task types.
+          class MigrationTaskResult
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Translation specific result details from the migration task.
+          # @!attribute [rw] translated_literals
+          #   @return [::Array<::Google::Cloud::Bigquery::Migration::V2::Literal>]
+          #     The list of the translated literals.
+          # @!attribute [rw] report_log_messages
+          #   @return [::Array<::Google::Cloud::Bigquery::Migration::V2::GcsReportLogMessage>]
+          #     The records from the aggregate CSV report for a migration workflow.
+          class TranslationTaskResult
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/cloud/bigquery/migration/v2/translation_config.rb

@@ -45,6 +45,12 @@ module Google
           # @!attribute [rw] request_source
           #   @return [::String]
           #     The indicator to show translation request initiator.
+          # @!attribute [rw] target_types
+          #   @return [::Array<::String>]
+          #     The types of output to generate, e.g. sql, metadata etc. If not specified,
+          #     a default set of targets will be generated. Some additional target types
+          #     may be slower to generate. See the documentation for the set of available
+          #     target types.
           class TranslationConfigDetails
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -93,6 +99,15 @@ module Google
           # @!attribute [rw] mysql_dialect
           #   @return [::Google::Cloud::Bigquery::Migration::V2::MySQLDialect]
           #     The MySQL dialect
+          # @!attribute [rw] db2_dialect
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::DB2Dialect]
+          #     DB2 dialect
+          # @!attribute [rw] sqlite_dialect
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::SQLiteDialect]
+          #     SQLite dialect
+          # @!attribute [rw] greenplum_dialect
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::GreenplumDialect]
+          #     Greenplum dialect
           class Dialect
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -197,6 +212,24 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # The dialect definition for DB2.
+          class DB2Dialect
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The dialect definition for SQLite.
+          class SQLiteDialect
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The dialect definition for Greenplum.
+          class GreenplumDialect
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Represents a map of name mappings using a list of key:value proto messages of
           # existing name to desired output name.
           # @!attribute [rw] name_map
@@ -303,6 +336,14 @@ module Google
           #   @return [::Array<::String>]
           #     The schema search path. When SQL objects are missing schema name,
           #     translation engine will search through this list to find the value.
+          # @!attribute [rw] metadata_store_dataset
+          #   @return [::String]
+          #     Optional. Expects a valid BigQuery dataset ID that exists, e.g.,
+          #     project-123.metadata_store_123.  If specified, translation will search and
+          #     read the required schema information from a metadata store in this dataset.
+          #     If metadata store doesn't exist, translation will parse the metadata file
+          #     and upload the schema info to a temp table in the dataset to speed up
+          #     future translation jobs.
           class SourceEnv
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/bigquery/migration/v2/translation_details.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Bigquery
+      module Migration
+        module V2
+          # The translation details to capture the necessary settings for a translation
+          # job.
+          # @!attribute [rw] source_target_mapping
+          #   @return [::Array<::Google::Cloud::Bigquery::Migration::V2::SourceTargetMapping>]
+          #     The mapping from source to target SQL.
+          # @!attribute [rw] target_base_uri
+          #   @return [::String]
+          #     The base URI for all writes to persistent storage.
+          # @!attribute [rw] source_environment
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::SourceEnvironment]
+          #     The default source environment values for the translation.
+          # @!attribute [rw] target_return_literals
+          #   @return [::Array<::String>]
+          #     The list of literal targets that will be directly returned to the response.
+          #     Each entry consists of the constructed path, EXCLUDING the base path. Not
+          #     providing a target_base_uri will prevent writing to persistent storage.
+          # @!attribute [rw] target_types
+          #   @return [::Array<::String>]
+          #     The types of output to generate, e.g. sql, metadata,
+          #     lineage_from_sql_scripts, etc. If not specified, a default set of
+          #     targets will be generated. Some additional target types may be slower to
+          #     generate. See the documentation for the set of available target types.
+          class TranslationDetails
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents one mapping from a source SQL to a target SQL.
+          # @!attribute [rw] source_spec
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::SourceSpec]
+          #     The source SQL or the path to it.
+          # @!attribute [rw] target_spec
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::TargetSpec]
+          #     The target SQL or the path for it.
+          class SourceTargetMapping
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents one path to the location that holds source data.
+          # @!attribute [rw] base_uri
+          #   @return [::String]
+          #     The base URI for all files to be read in as sources for translation.
+          # @!attribute [rw] literal
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::Literal]
+          #     Source literal.
+          # @!attribute [rw] encoding
+          #   @return [::String]
+          #     Optional. The optional field to specify the encoding of the sql bytes.
+          class SourceSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents one path to the location that holds target data.
+          # @!attribute [rw] relative_path
+          #   @return [::String]
+          #     The relative path for the target data. Given source file
+          #     `base_uri/input/sql`, the output would be
+          #     `target_base_uri/sql/relative_path/input.sql`.
+          class TargetSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Literal data.
+          # @!attribute [rw] literal_string
+          #   @return [::String]
+          #     Literal string data.
+          # @!attribute [rw] literal_bytes
+          #   @return [::String]
+          #     Literal byte data.
+          # @!attribute [rw] relative_path
+          #   @return [::String]
+          #     Required. The identifier of the literal entry.
+          class Literal
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents the default source environment values for the translation.
+          # @!attribute [rw] default_database
+          #   @return [::String]
+          #     The default database name to fully qualify SQL objects when their database
+          #     name is missing.
+          # @!attribute [rw] schema_search_path
+          #   @return [::Array<::String>]
+          #     The schema search path. When SQL objects are missing schema name,
+          #     translation engine will search through this list to find the value.
+          # @!attribute [rw] metadata_store_dataset
+          #   @return [::String]
+          #     Optional. Expects a validQ BigQuery dataset ID that exists, e.g.,
+          #     project-123.metadata_store_123.  If specified, translation will search and
+          #     read the required schema information from a metadata store in this dataset.
+          #     If metadata store doesn't exist, translation will parse the metadata file
+          #     and upload the schema info to a temp table in the dataset to speed up
+          #     future translation jobs.
+          class SourceEnvironment
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/bigquery/migration/v2/translation_suggestion.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Copyright 2024 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Bigquery
+      module Migration
+        module V2
+          # Details about a record.
+          # @!attribute [rw] severity
+          #   @return [::Google::Cloud::Bigquery::Migration::V2::TranslationReportRecord::Severity]
+          #     Severity of the translation record.
+          # @!attribute [rw] script_line
+          #   @return [::Integer]
+          #     Specifies the row from the source text where the error occurred (0 based).
+          #     Example: 2
+          # @!attribute [rw] script_column
+          #   @return [::Integer]
+          #     Specifies the column from the source texts where the error occurred. (0
+          #     based) example: 6
+          # @!attribute [rw] category
+          #   @return [::String]
+          #     Category of the error/warning. Example: SyntaxError
+          # @!attribute [rw] message
+          #   @return [::String]
+          #     Detailed message of the record.
+          class TranslationReportRecord
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The severity type of the record.
+            module Severity
+              # SeverityType not specified.
+              SEVERITY_UNSPECIFIED = 0
+
+              # INFO type.
+              INFO = 1
+
+              # WARNING type. The translated query may still provide useful information
+              # if all the report records are WARNING.
+              WARNING = 2
+
+              # ERROR type. Translation failed.
+              ERROR = 3
+            end
+          end
+        end
+      end
+    end
+  end
+end