google-cloud-spanner 1.13.1 → 1.16.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7bba4c8dab3ed8067ad0e2d59049021c7a5fce7d87fd1ed0f20226314fd8a214
-  data.tar.gz: '08033542e0725a4eb7424291a02ae6f1cc1495d1a407d91d84d95d8b23fe02a1'
+  metadata.gz: e20c16755d63cea713e0e2b48f0ad0d470e24da1429e8aa1cb62945ee6388ddd
+  data.tar.gz: 347112cc47df35de0d4cbdb24b39447860ba4c6c5f477e46d9bdbb45ab464796
 SHA512:
-  metadata.gz: 5a839007b3e28db0b4d206af5249410d506ada44956bce6ff899ed1c6e18cd9445a5b7e6930e80fc6ee7c7d930d87ddb4d3375b3a213371a2f42bd857788ac41
-  data.tar.gz: 410e358dd4451e98f3527ee027f19b14e5b8306924176a2fe6bdb2469f116c1b0110ecde7280abbc7ae35368ed57253113f27b64ac2b88053bc5abd4bb270d0c
+  metadata.gz: 14ddd7286340c3520e2b1e0bedc018b48ceef0025fe78043f92c91af5af795e7f7eed027f61659fb232135cf45d6f249d083831bb95d960c622f2cf38dbf582e
+  data.tar.gz: 126b39a51fdd3a1673a1a8acd93548ad54ef29938b6dfc793bfd24f728eae6844ade5ca0e6780c3cfeae9aa22a31b307259585b14ec8da65e7e199c7c04393ee

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Release History
 
+### 1.16.2 / 2020-05-28
+
+#### Documentation
+
+* Fix a few broken links
+
+### 1.16.1 / 2020-05-21
+
+#### Bug Fixes
+
+* Increased default timeouts to match clients in other languages
+* Run system tests against the emulator, skipping those not supported by the emulator
+* Do not require a key file when running against the emulator
+
+### 1.16.0 / 2020-03-20
+
+#### Features
+
+* Added support for backing up and restoring databases  ([#5053](https://www.github.com/googleapis/google-cloud-ruby/issues/5053))
+
+### 1.15.0 / 2020-03-15
+
+#### Features
+
+* Added support for query options ([#4907](https://www.github.com/googleapis/google-cloud-ruby/issues/4907))
+  * Added support for specifying the query optimizer version.
+* Support separate project setting for quota/billing
+
+### 1.14.0 / 2020-02-18
+
+#### Features
+
+* allow custom lib name and version for telemetry purpose ([#4762](https://www.github.com/googleapis/google-cloud-ruby/issues/4762))
+  * allow custom lib name and version for telemetry purpose
+  * format docs
+  * added custom lib name and version prefix
+  * update test cases for lib name and version
+
 ### 1.13.1 / 2020-01-22
 
 #### Documentation

data/CONTRIBUTING.md

@@ -53,7 +53,7 @@ there is a small amount of setup:
 In order to run code interactively, you can automatically load
 google-cloud-spanner and its dependencies in IRB. This requires that your
 developer environment has already been configured by following the steps
-described in the [Authentication Guide](AUTHENTICATION.md). An IRB console
+described in the {file:AUTHENTICATION.md Authentication Guide}. An IRB console
 can be created with:
 
 ```sh
@@ -119,7 +119,7 @@ If you alter an example's title, you may encounter breaking tests.
 ### Spanner Acceptance Tests
 
 The Spanner acceptance tests interact with the live service API. Follow the
-instructions in the [Authentication Guide](AUTHENTICATION.md) for enabling
+instructions in the {file:AUTHENTICATION.md Authentication Guide} for enabling
 the Spanner API. Occasionally, some API features may not yet be generally
 available, making it difficult for some contributors to successfully run the
 entire acceptance test suite. However, please ensure that you do successfully
@@ -127,7 +127,7 @@ run acceptance tests for any code areas covered by your pull request.
 
 To run the acceptance tests, first create and configure a project in the Google
 Developers Console, as described in the
-[Authentication Guide](AUTHENTICATION.md). Be sure to download the JSON KEY
+{file:AUTHENTICATION.md Authentication Guide}. Be sure to download the JSON KEY
 file. Make note of the PROJECT_ID and the KEYFILE location on your system.
 
 Before you can run the Spanner acceptance tests, you must first create indexes
@@ -184,5 +184,5 @@ $ bundle exec rake rubocop
 ## Code of Conduct
 
 Please note that this project is released with a Contributor Code of Conduct. By
-participating in this project you agree to abide by its terms. See
-[Code of Conduct](CODE_OF_CONDUCT.md) for more information.
+participating in this project you agree to abide by its terms. See the
+{file:CODE_OF_CONDUCT.md Code of Conduct} for more information.

data/TROUBLESHOOTING.md

@@ -24,14 +24,8 @@ improved, *please* create a new issue on GitHub so we can talk about it.
 
   - [New issue][gh-ruby]
 
-Or, you can ask questions on the [Google Cloud Platform Slack][slack-ruby]. You
-can use the "ruby" channel for general Ruby questions, or use the
-"google-cloud-ruby" channel if you have questions about this gem in particular.
-
 [so-ruby]: http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby+spanner
 
 [gh-search-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues?q=label%3A%22api%3A+spanner%22
 
 [gh-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues/new
-
-[slack-ruby]: https://gcp-slack.appspot.com/

data/lib/google-cloud-spanner.rb

@@ -45,6 +45,20 @@ module Google
     # @param [Integer] timeout Default timeout to use in requests. Optional.
     # @param [Hash] client_config A hash of values to override the default
     #   behavior of the API client. Optional.
+    # @param [String] lib_name Library name. This will be added as a prefix
+    #   to the API call tracking header `x-goog-api-client` with provided
+    #   lib version for telemetry. Optional. For example prefix looks like
+    #   `spanner-activerecord/0.0.1 gccl/1.13.1`. Here,
+    #   `spanner-activerecord/0.0.1` is provided custom library name and
+    #   version and `gccl/1.13.1` represents the Cloud Spanner Ruby library
+    #   with version.
+    # @param [String] lib_version Library version. This will be added as a
+    #   prefix to the API call tracking header `x-goog-api-client` with
+    #   provided lib name for telemetry. Optional. For example prefix look like
+    #   `spanner-activerecord/0.0.1 gccl/1.13.1`. Here,
+    #   `spanner-activerecord/0.0.1` is provided custom library name and
+    #   version and `gccl/1.13.1` represents the Cloud Spanner Ruby library
+    #   with version.
     #
     # @return [Google::Cloud::Spanner::Project]
     #
@@ -61,10 +75,13 @@ module Google
     #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
     #   spanner = gcloud.spanner scope: platform_scope
     #
-    def spanner scope: nil, timeout: nil, client_config: nil
+    def spanner scope: nil, timeout: nil, client_config: nil, lib_name: nil,
+                lib_version: nil
       Google::Cloud.spanner @project, @keyfile, scope: scope,
                                                 timeout: (timeout || @timeout),
-                                                client_config: client_config
+                                                client_config: client_config,
+                                                lib_name: lib_name,
+                                                lib_version: lib_version
     end
 
     ##
@@ -92,6 +109,20 @@ module Google
     # @param [Integer] timeout Default timeout to use in requests. Optional.
     # @param [Hash] client_config A hash of values to override the default
     #   behavior of the API client. Optional.
+    # @param [String] lib_name Library name. This will be added as a prefix
+    #   to the API call tracking header `x-goog-api-client` with provided
+    #   lib version for telemetry. Optional. For example prefix looks like
+    #   `spanner-activerecord/0.0.1 gccl/1.13.1`. Here,
+    #   `spanner-activerecord/0.0.1` is provided custom library name and
+    #   version and `gccl/1.13.1` represents the Cloud Spanner Ruby library
+    #   with version.
+    # @param [String] lib_version Library version. This will be added as a
+    #   prefix to the API call tracking header `x-goog-api-client` with
+    #   provided lib name for telemetry. Optional. For example prefix look like
+    #   `spanner-activerecord/0.0.1 gccl/1.13.1`. Here,
+    #   `spanner-activerecord/0.0.1` is provided custom library name and
+    #   version and `gccl/1.13.1` represents the Cloud Spanner Ruby library
+    #   with version.
     #
     # @return [Google::Cloud::Spanner::Project]
     #
@@ -101,16 +132,20 @@ module Google
     #   spanner = Google::Cloud.spanner
     #
     def self.spanner project_id = nil, credentials = nil, scope: nil,
-                     timeout: nil, client_config: nil
+                     timeout: nil, client_config: nil, lib_name: nil,
+                     lib_version: nil
       require "google/cloud/spanner"
       Google::Cloud::Spanner.new project_id: project_id,
                                  credentials: credentials,
                                  scope: scope, timeout: timeout,
-                                 client_config: client_config
+                                 client_config: client_config,
+                                 lib_name: lib_name, lib_version: lib_version
     end
   end
 end
 
+# rubocop:disable Metrics/BlockLength
+
 # Set the default spanner configuration
 Google::Cloud.configure.add_config! :spanner do |config|
   default_project = Google::Cloud::Config.deferred do
@@ -126,6 +161,14 @@ Google::Cloud.configure.add_config! :spanner do |config|
     ENV["SPANNER_EMULATOR_HOST"]
   end
 
+  default_query_options = Google::Cloud::Config.deferred do
+    query_options = {}
+    optimizer_version = ENV["SPANNER_OPTIMIZER_VERSION"]
+    query_options[:optimizer_version] = optimizer_version if optimizer_version
+    query_options = nil if query_options.empty?
+    query_options
+  end
+
   config.add_field! :project_id, default_project, match: String, allow_nil: true
   config.add_alias! :project, :project_id
   config.add_field! :credentials, default_creds,
@@ -137,4 +180,9 @@ Google::Cloud.configure.add_config! :spanner do |config|
   config.add_field! :client_config, nil, match: Hash
   config.add_field! :endpoint, nil, match: String
   config.add_field! :emulator_host, default_emulator, match: String, allow_nil: true
+  config.add_field! :lib_name, nil, match: String, allow_nil: true
+  config.add_field! :lib_version, nil, match: String, allow_nil: true
+  config.add_field! :query_options, default_query_options, match: Hash, allow_nil: true
 end
+
+# rubocop:enable Metrics/BlockLength

data/lib/google/cloud/spanner.rb

@@ -34,7 +34,7 @@ module Google
     # See {file:OVERVIEW.md Spanner Overview}.
     #
     module Spanner
-      # rubocop:disable Metrics/MethodLength
+      # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
 
       ##
       # Creates a new object for connecting to the Spanner service.
@@ -68,6 +68,20 @@ module Google
       #   Deprecated.
       # @param [String] emulator_host Spanner emulator host. Optional.
       #   If the param is nil, uses the value of the `emulator_host` config.
+      # @param [String] lib_name Library name. This will be added as a prefix
+      #   to the API call tracking header `x-goog-api-client` with provided
+      #   lib version for telemetry. Optional. For example prefix looks like
+      #   `spanner-activerecord/0.0.1 gccl/1.13.1`. Here,
+      #   `spanner-activerecord/0.0.1` is provided custom library name and
+      #   version and `gccl/1.13.1` represents the Cloud Spanner Ruby library
+      #   with version.
+      # @param [String] lib_version Library version. This will be added as a
+      #   prefix to the API call tracking header `x-goog-api-client` with
+      #   provided lib name for telemetry. Optional. For example prefix look like
+      #   `spanner-activerecord/0.0.1 gccl/1.13.1`. Here,
+      #   `spanner-activerecord/0.0.1` is provided custom library name and
+      #   version and `gccl/1.13.1` represents the Cloud Spanner Ruby library
+      #   with version.
       #
       # @return [Google::Cloud::Spanner::Project]
       #
@@ -78,7 +92,7 @@ module Google
       #
       def self.new project_id: nil, credentials: nil, scope: nil, timeout: nil,
                    client_config: nil, endpoint: nil, project: nil, keyfile: nil,
-                   emulator_host: nil
+                   emulator_host: nil, lib_name: nil, lib_version: nil
         project_id    ||= (project || default_project_id)
         scope         ||= configure.scope
         timeout       ||= configure.timeout
@@ -86,6 +100,8 @@ module Google
         endpoint      ||= configure.endpoint
         credentials   ||= (keyfile || default_credentials(scope: scope))
         emulator_host ||= configure.emulator_host
+        lib_name      ||= configure.lib_name
+        lib_version   ||= configure.lib_version
 
         if emulator_host
           credentials = :this_channel_is_insecure
@@ -106,12 +122,14 @@ module Google
         Spanner::Project.new(
           Spanner::Service.new(
             project_id, credentials,
-            host: endpoint, timeout: timeout, client_config: client_config
-          )
+            host: endpoint, timeout: timeout, client_config: client_config,
+            lib_name: lib_name, lib_version: lib_version
+          ),
+          query_options: configure.query_options
         )
       end
 
-      # rubocop:enable Metrics/MethodLength
+      # rubocop:enable Metrics/MethodLength,Metrics/AbcSize
 
       ##
       # Configure the Google Cloud Spanner library.
@@ -133,6 +151,12 @@ module Google
       #   to use the default endpoint.
       # * `emulator_host` - (String) Host name of the emulator. Defaults to
       #   `ENV["SPANNER_EMULATOR_HOST"]`.
+      # * `lib_name` - (String) Override the lib name , or `nil`
+      #   to use the default lib name without prefix in agent tracking
+      #   header.
+      # * `lib_version` - (String) Override the lib version , or `nil`
+      #   to use the default version lib name without prefix in agent
+      #   tracking header.
       #
       # @return [Google::Cloud::Config] The configuration object the
       #   Google::Cloud::Spanner library uses.

data/lib/google/cloud/spanner/admin/database.rb

@@ -23,7 +23,7 @@ module Google
         # rubocop:disable LineLength
 
         ##
-        # # Ruby Client for Cloud Spanner Database Admin API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
+        # # Ruby Client for Cloud Spanner Database Admin API
         #
         # [Cloud Spanner Database Admin API][Product Documentation]:
         #
@@ -93,7 +93,8 @@ module Google
           #
           # The Cloud Spanner Database Admin API can be used to create, drop, and
           # list databases. It also enables updating the schema of pre-existing
-          # databases.
+          # databases. It can be also used to create, delete and list backups for a
+          # database and to restore from an existing backup.
           #
           # @param version [Symbol, String]
           #   The major version of the service to be used. By default :v1

data/lib/google/cloud/spanner/admin/database/v1.rb

@@ -24,7 +24,7 @@ module Google
           # rubocop:disable LineLength
 
           ##
-          # # Ruby Client for Cloud Spanner Database Admin API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
+          # # Ruby Client for Cloud Spanner Database Admin API
           #
           # [Cloud Spanner Database Admin API][Product Documentation]:
           #
@@ -86,7 +86,8 @@ module Google
             #
             # The Cloud Spanner Database Admin API can be used to create, drop, and
             # list databases. It also enables updating the schema of pre-existing
-            # databases.
+            # databases. It can be also used to create, delete and list backups for a
+            # database and to restore from an existing backup.
             #
             # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
             #   Provides the means for authenticating requests made by the client. This parameter can

data/lib/google/cloud/spanner/admin/database/v1/database_admin_client.rb

@@ -41,7 +41,8 @@ module Google
             #
             # The Cloud Spanner Database Admin API can be used to create, drop, and
             # list databases. It also enables updating the schema of pre-existing
-            # databases.
+            # databases. It can be also used to create, delete and list backups for a
+            # database and to restore from an existing backup.
             #
             # @!attribute [r] database_admin_stub
             #   @return [Google::Spanner::Admin::Database::V1::DatabaseAdmin::Stub]
@@ -64,7 +65,19 @@ module Google
                 "list_databases" => Google::Gax::PageDescriptor.new(
                   "page_token",
                   "next_page_token",
-                  "databases")
+                  "databases"),
+                "list_backups" => Google::Gax::PageDescriptor.new(
+                  "page_token",
+                  "next_page_token",
+                  "backups"),
+                "list_database_operations" => Google::Gax::PageDescriptor.new(
+                  "page_token",
+                  "next_page_token",
+                  "operations"),
+                "list_backup_operations" => Google::Gax::PageDescriptor.new(
+                  "page_token",
+                  "next_page_token",
+                  "operations")
               }.freeze
 
               private_constant :PAGE_DESCRIPTORS
@@ -82,6 +95,12 @@ module Google
                 self::GRPC_INTERCEPTORS = DatabaseAdminClient::GRPC_INTERCEPTORS
               end
 
+              BACKUP_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+                "projects/{project}/instances/{instance}/backups/{backup}"
+              )
+
+              private_constant :BACKUP_PATH_TEMPLATE
+
               DATABASE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
                 "projects/{project}/instances/{instance}/databases/{database}"
               )
@@ -94,6 +113,19 @@ module Google
 
               private_constant :INSTANCE_PATH_TEMPLATE
 
+              # Returns a fully-qualified backup resource name string.
+              # @param project [String]
+              # @param instance [String]
+              # @param backup [String]
+              # @return [String]
+              def self.backup_path project, instance, backup
+                BACKUP_PATH_TEMPLATE.render(
+                  :"project" => project,
+                  :"instance" => instance,
+                  :"backup" => backup
+                )
+              end
+
               # Returns a fully-qualified database resource name string.
               # @param project [String]
               # @param instance [String]
@@ -207,6 +239,9 @@ module Google
                 google_api_client.freeze
 
                 headers = { :"x-goog-api-client" => google_api_client }
+                if credentials.respond_to?(:quota_project_id) && credentials.quota_project_id
+                  headers[:"x-goog-user-project"] = credentials.quota_project_id
+                end
                 headers.merge!(metadata) unless metadata.nil?
                 client_config_file = Pathname.new(__dir__).join(
                   "database_admin_client_config.json"
@@ -311,6 +346,70 @@ module Google
                     {'resource' => request.resource}
                   end
                 )
+                @create_backup = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:create_backup),
+                  defaults["create_backup"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
+                )
+                @get_backup = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:get_backup),
+                  defaults["get_backup"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'name' => request.name}
+                  end
+                )
+                @update_backup = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:update_backup),
+                  defaults["update_backup"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'backup.name' => request.backup.name}
+                  end
+                )
+                @delete_backup = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:delete_backup),
+                  defaults["delete_backup"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'name' => request.name}
+                  end
+                )
+                @list_backups = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:list_backups),
+                  defaults["list_backups"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
+                )
+                @restore_database = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:restore_database),
+                  defaults["restore_database"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
+                )
+                @list_database_operations = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:list_database_operations),
+                  defaults["list_database_operations"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
+                )
+                @list_backup_operations = Google::Gax.create_api_call(
+                  @database_admin_stub.method(:list_backup_operations),
+                  defaults["list_backup_operations"],
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
+                )
               end
 
               # Service calls
@@ -375,8 +474,8 @@ module Google
               # have a name of the format `<database_name>/operations/<operation_id>` and
               # can be used to track preparation of the database. The
               # {Google::Longrunning::Operation#metadata metadata} field type is
-              # {Google::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}.
-              # The {Google::Longrunning::Operation#response response} field type is
+              # {Google::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}. The
+              # {Google::Longrunning::Operation#response response} field type is
               # {Google::Spanner::Admin::Database::V1::Database Database}, if successful.
               #
               # @param parent [String]
@@ -389,7 +488,7 @@ module Google
               #   If the database ID is a reserved word or if it contains a hyphen, the
               #   database ID must be enclosed in backticks (`` ` ``).
               # @param extra_statements [Array<String>]
-              #   An optional list of DDL statements to run inside the newly created
+              #   Optional. A list of DDL statements to run inside the newly created
               #   database. Statements can create tables, indexes, etc. These
               #   statements execute atomically with the creation of the database:
               #   if there is an error in any statement, the database is not created.
@@ -493,8 +592,7 @@ module Google
               # the format `<database_name>/operations/<operation_id>` and can be used to
               # track execution of the schema change(s). The
               # {Google::Longrunning::Operation#metadata metadata} field type is
-              # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.
-              # The operation has no response.
+              # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.  The operation has no response.
               #
               # @param database [String]
               #   Required. The database to update.
@@ -508,20 +606,18 @@ module Google
               #
               #   Specifying an explicit operation ID simplifies determining
               #   whether the statements were executed in the event that the
-              #   {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl}
-              #   call is replayed, or the return value is otherwise lost: the
-              #   {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database}
-              #   and `operation_id` fields can be combined to form the
+              #   {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} call is replayed,
+              #   or the return value is otherwise lost: the {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database} and
+              #   `operation_id` fields can be combined to form the
               #   {Google::Longrunning::Operation#name name} of the resulting
-              #   {Google::Longrunning::Operation longrunning::Operation}:
-              #   `<database>/operations/<operation_id>`.
+              #   {Google::Longrunning::Operation longrunning::Operation}: `<database>/operations/<operation_id>`.
               #
               #   `operation_id` should be unique within the database, and must be
               #   a valid identifier: `[a-z][a-z0-9_]*`. Note that
               #   automatically-generated operation IDs always begin with an
               #   underscore. If the named operation already exists,
-              #   {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl}
-              #   returns `ALREADY_EXISTS`.
+              #   {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} returns
+              #   `ALREADY_EXISTS`.
               # @param options [Google::Gax::CallOptions]
               #   Overrides the default settings for this call, e.g, timeout,
               #   retries, etc.
@@ -586,6 +682,8 @@ module Google
               end
 
               # Drops (aka deletes) a Cloud Spanner database.
+              # Completed backups for the database will be retained according to their
+              # `expire_time`.
               #
               # @param database [String]
               #   Required. The database to be dropped.
@@ -647,11 +745,13 @@ module Google
                 @get_database_ddl.call(req, options, &block)
               end
 
-              # Sets the access control policy on a database resource.
+              # Sets the access control policy on a database or backup resource.
               # Replaces any existing policy.
               #
               # Authorization requires `spanner.databases.setIamPolicy`
               # permission on {Google::Iam::V1::SetIamPolicyRequest#resource resource}.
+              # For backups, authorization requires `spanner.backups.setIamPolicy`
+              # permission on {Google::Iam::V1::SetIamPolicyRequest#resource resource}.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy is being specified.
@@ -694,12 +794,14 @@ module Google
                 @set_iam_policy.call(req, options, &block)
               end
 
-              # Gets the access control policy for a database resource.
-              # Returns an empty policy if a database exists but does
-              # not have a policy set.
+              # Gets the access control policy for a database or backup resource.
+              # Returns an empty policy if a database or backup exists but does not have a
+              # policy set.
               #
               # Authorization requires `spanner.databases.getIamPolicy` permission on
               # {Google::Iam::V1::GetIamPolicyRequest#resource resource}.
+              # For backups, authorization requires `spanner.backups.getIamPolicy`
+              # permission on {Google::Iam::V1::GetIamPolicyRequest#resource resource}.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy is being requested.
@@ -737,12 +839,16 @@ module Google
                 @get_iam_policy.call(req, options, &block)
               end
 
-              # Returns permissions that the caller has on the specified database resource.
+              # Returns permissions that the caller has on the specified database or backup
+              # resource.
               #
               # Attempting this RPC on a non-existent Cloud Spanner database will
               # result in a NOT_FOUND error if the user has
               # `spanner.databases.list` permission on the containing Cloud
               # Spanner instance. Otherwise returns an empty set of permissions.
+              # Calling this method on a backup that does not exist will
+              # result in a NOT_FOUND error if the user has
+              # `spanner.backups.list` permission on the containing instance.
               #
               # @param resource [String]
               #   REQUIRED: The resource for which the policy detail is being requested.
@@ -782,6 +888,622 @@ module Google
                 req = Google::Gax::to_proto(req, Google::Iam::V1::TestIamPermissionsRequest)
                 @test_iam_permissions.call(req, options, &block)
               end
+
+              # Starts creating a new Cloud Spanner Backup.
+              # The returned backup {Google::Longrunning::Operation long-running operation}
+              # will have a name of the format
+              # `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
+              # and can be used to track creation of the backup. The
+              # {Google::Longrunning::Operation#metadata metadata} field type is
+              # {Google::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}. The
+              # {Google::Longrunning::Operation#response response} field type is
+              # {Google::Spanner::Admin::Database::V1::Backup Backup}, if successful. Cancelling the returned operation will stop the
+              # creation and delete the backup.
+              # There can be only one pending backup creation per database. Backup creation
+              # of different databases can run concurrently.
+              #
+              # @param parent [String]
+              #   Required. The name of the instance in which the backup will be
+              #   created. This must be the same instance that contains the database the
+              #   backup will be created from. The backup will be stored in the
+              #   location(s) specified in the instance configuration of this
+              #   instance. Values are of the form
+              #   `projects/<project>/instances/<instance>`.
+              # @param backup_id [String]
+              #   Required. The id of the backup to be created. The `backup_id` appended to
+              #   `parent` forms the full backup name of the form
+              #   `projects/<project>/instances/<instance>/backups/<backup_id>`.
+              # @param backup [Google::Spanner::Admin::Database::V1::Backup | Hash]
+              #   Required. The backup to create.
+              #   A hash of the same form as `Google::Spanner::Admin::Database::V1::Backup`
+              #   can also be provided.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @return [Google::Gax::Operation]
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #
+              #   # TODO: Initialize `backup_id`:
+              #   backup_id = ''
+              #
+              #   # TODO: Initialize `backup`:
+              #   backup = {}
+              #
+              #   # Register a callback during the method call.
+              #   operation = database_admin_client.create_backup(formatted_parent, backup_id, backup) do |op|
+              #     raise op.results.message if op.error?
+              #     op_results = op.results
+              #     # Process the results.
+              #
+              #     metadata = op.metadata
+              #     # Process the metadata.
+              #   end
+              #
+              #   # Or use the return value to register a callback.
+              #   operation.on_done do |op|
+              #     raise op.results.message if op.error?
+              #     op_results = op.results
+              #     # Process the results.
+              #
+              #     metadata = op.metadata
+              #     # Process the metadata.
+              #   end
+              #
+              #   # Manually reload the operation.
+              #   operation.reload!
+              #
+              #   # Or block until the operation completes, triggering callbacks on
+              #   # completion.
+              #   operation.wait_until_done!
+
+              def create_backup \
+                  parent,
+                  backup_id,
+                  backup,
+                  options: nil
+                req = {
+                  parent: parent,
+                  backup_id: backup_id,
+                  backup: backup
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::CreateBackupRequest)
+                operation = Google::Gax::Operation.new(
+                  @create_backup.call(req, options),
+                  @operations_client,
+                  Google::Spanner::Admin::Database::V1::Backup,
+                  Google::Spanner::Admin::Database::V1::CreateBackupMetadata,
+                  call_options: options
+                )
+                operation.on_done { |operation| yield(operation) } if block_given?
+                operation
+              end
+
+              # Gets metadata on a pending or completed {Google::Spanner::Admin::Database::V1::Backup Backup}.
+              #
+              # @param name [String]
+              #   Required. Name of the backup.
+              #   Values are of the form
+              #   `projects/<project>/instances/<instance>/backups/<backup>`.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @yield [result, operation] Access the result along with the RPC operation
+              # @yieldparam result [Google::Spanner::Admin::Database::V1::Backup]
+              # @yieldparam operation [GRPC::ActiveCall::Operation]
+              # @return [Google::Spanner::Admin::Database::V1::Backup]
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_name = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.backup_path("[PROJECT]", "[INSTANCE]", "[BACKUP]")
+              #   response = database_admin_client.get_backup(formatted_name)
+
+              def get_backup \
+                  name,
+                  options: nil,
+                  &block
+                req = {
+                  name: name
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::GetBackupRequest)
+                @get_backup.call(req, options, &block)
+              end
+
+              # Updates a pending or completed {Google::Spanner::Admin::Database::V1::Backup Backup}.
+              #
+              # @param backup [Google::Spanner::Admin::Database::V1::Backup | Hash]
+              #   Required. The backup to update. `backup.name`, and the fields to be updated
+              #   as specified by `update_mask` are required. Other fields are ignored.
+              #   Update is only supported for the following fields:
+              #   * `backup.expire_time`.
+              #   A hash of the same form as `Google::Spanner::Admin::Database::V1::Backup`
+              #   can also be provided.
+              # @param update_mask [Google::Protobuf::FieldMask | Hash]
+              #   Required. A mask specifying which fields (e.g. `expire_time`) in the
+              #   Backup resource should be updated. This mask is relative to the Backup
+              #   resource, not to the request message. The field mask must always be
+              #   specified; this prevents any future fields from being erased accidentally
+              #   by clients that do not know about them.
+              #   A hash of the same form as `Google::Protobuf::FieldMask`
+              #   can also be provided.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @yield [result, operation] Access the result along with the RPC operation
+              # @yieldparam result [Google::Spanner::Admin::Database::V1::Backup]
+              # @yieldparam operation [GRPC::ActiveCall::Operation]
+              # @return [Google::Spanner::Admin::Database::V1::Backup]
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #
+              #   # TODO: Initialize `backup`:
+              #   backup = {}
+              #
+              #   # TODO: Initialize `update_mask`:
+              #   update_mask = {}
+              #   response = database_admin_client.update_backup(backup, update_mask)
+
+              def update_backup \
+                  backup,
+                  update_mask,
+                  options: nil,
+                  &block
+                req = {
+                  backup: backup,
+                  update_mask: update_mask
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::UpdateBackupRequest)
+                @update_backup.call(req, options, &block)
+              end
+
+              # Deletes a pending or completed {Google::Spanner::Admin::Database::V1::Backup Backup}.
+              #
+              # @param name [String]
+              #   Required. Name of the backup to delete.
+              #   Values are of the form
+              #   `projects/<project>/instances/<instance>/backups/<backup>`.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @yield [result, operation] Access the result along with the RPC operation
+              # @yieldparam result []
+              # @yieldparam operation [GRPC::ActiveCall::Operation]
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_name = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.backup_path("[PROJECT]", "[INSTANCE]", "[BACKUP]")
+              #   database_admin_client.delete_backup(formatted_name)
+
+              def delete_backup \
+                  name,
+                  options: nil,
+                  &block
+                req = {
+                  name: name
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::DeleteBackupRequest)
+                @delete_backup.call(req, options, &block)
+                nil
+              end
+
+              # Lists completed and pending backups.
+              # Backups returned are ordered by `create_time` in descending order,
+              # starting from the most recent `create_time`.
+              #
+              # @param parent [String]
+              #   Required. The instance to list backups from.  Values are of the
+              #   form `projects/<project>/instances/<instance>`.
+              # @param filter [String]
+              #   An expression that filters the list of returned backups.
+              #
+              #   A filter expression consists of a field name, a comparison operator, and a
+              #   value for filtering.
+              #   The value must be a string, a number, or a boolean. The comparison operator
+              #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
+              #   Colon `:` is the contains operator. Filter rules are not case sensitive.
+              #
+              #   The following fields in the {Google::Spanner::Admin::Database::V1::Backup Backup} are eligible for filtering:
+              #
+              #   * `name`
+              #     * `database`
+              #     * `state`
+              #     * `create_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+              #     * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+              #     * `size_bytes`
+              #
+              #     You can combine multiple expressions by enclosing each expression in
+              #     parentheses. By default, expressions are combined with AND logic, but
+              #     you can specify AND, OR, and NOT logic explicitly.
+              #
+              #   Here are a few examples:
+              #
+              #   * `name:Howl` - The backup's name contains the string "howl".
+              #     * `database:prod`
+              #       * The database's name contains the string "prod".
+              #     * `state:CREATING` - The backup is pending creation.
+              #     * `state:READY` - The backup is fully created and ready for use.
+              #     * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")`
+              #       * The backup name contains the string "howl" and `create_time`
+              #         of the backup is before 2018-03-28T14:50:00Z.
+              #       * `expire_time < \"2018-03-28T14:50:00Z\"`
+              #         * The backup `expire_time` is before 2018-03-28T14:50:00Z.
+              #       * `size_bytes > 10000000000` - The backup's size is greater than 10GB
+              # @param page_size [Integer]
+              #   The maximum number of resources contained in the underlying API
+              #   response. If page streaming is performed per-resource, this
+              #   parameter does not affect the return value. If page streaming is
+              #   performed per-page, this determines the maximum number of
+              #   resources in a page.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @yield [result, operation] Access the result along with the RPC operation
+              # @yieldparam result [Google::Gax::PagedEnumerable<Google::Spanner::Admin::Database::V1::Backup>]
+              # @yieldparam operation [GRPC::ActiveCall::Operation]
+              # @return [Google::Gax::PagedEnumerable<Google::Spanner::Admin::Database::V1::Backup>]
+              #   An enumerable of Google::Spanner::Admin::Database::V1::Backup instances.
+              #   See Google::Gax::PagedEnumerable documentation for other
+              #   operations such as per-page iteration or access to the response
+              #   object.
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #
+              #   # TODO: Initialize `filter`:
+              #   filter = ''
+              #
+              #   # Iterate over all results.
+              #   database_admin_client.list_backups(formatted_parent, filter).each do |element|
+              #     # Process element.
+              #   end
+              #
+              #   # Or iterate over results one page at a time.
+              #   database_admin_client.list_backups(formatted_parent, filter).each_page do |page|
+              #     # Process each page at a time.
+              #     page.each do |element|
+              #       # Process element.
+              #     end
+              #   end
+
+              def list_backups \
+                  parent,
+                  filter,
+                  page_size: nil,
+                  options: nil,
+                  &block
+                req = {
+                  parent: parent,
+                  filter: filter,
+                  page_size: page_size
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::ListBackupsRequest)
+                @list_backups.call(req, options, &block)
+              end
+
+              # Create a new database by restoring from a completed backup. The new
+              # database must be in the same project and in an instance with the same
+              # instance configuration as the instance containing
+              # the backup. The returned database [long-running
+              # operation][google.longrunning.Operation] has a name of the format
+              # `projects/<project>/instances/<instance>/databases/<database>/operations/<operation_id>`,
+              # and can be used to track the progress of the operation, and to cancel it.
+              # The {Google::Longrunning::Operation#metadata metadata} field type is
+              # {Google::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}.
+              # The {Google::Longrunning::Operation#response response} type
+              # is {Google::Spanner::Admin::Database::V1::Database Database}, if
+              # successful. Cancelling the returned operation will stop the restore and
+              # delete the database.
+              # There can be only one database being restored into an instance at a time.
+              # Once the restore operation completes, a new restore operation can be
+              # initiated, without waiting for the optimize operation associated with the
+              # first restore to complete.
+              #
+              # @param parent [String]
+              #   Required. The name of the instance in which to create the
+              #   restored database. This instance must be in the same project and
+              #   have the same instance configuration as the instance containing
+              #   the source backup. Values are of the form
+              #   `projects/<project>/instances/<instance>`.
+              # @param database_id [String]
+              #   Required. The id of the database to create and restore to. This
+              #   database must not already exist. The `database_id` appended to
+              #   `parent` forms the full database name of the form
+              #   `projects/<project>/instances/<instance>/databases/<database_id>`.
+              # @param backup [String]
+              #   Name of the backup from which to restore.  Values are of the form
+              #   `projects/<project>/instances/<instance>/backups/<backup>`.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @return [Google::Gax::Operation]
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #
+              #   # TODO: Initialize `database_id`:
+              #   database_id = ''
+              #
+              #   # Register a callback during the method call.
+              #   operation = database_admin_client.restore_database(formatted_parent, database_id) do |op|
+              #     raise op.results.message if op.error?
+              #     op_results = op.results
+              #     # Process the results.
+              #
+              #     metadata = op.metadata
+              #     # Process the metadata.
+              #   end
+              #
+              #   # Or use the return value to register a callback.
+              #   operation.on_done do |op|
+              #     raise op.results.message if op.error?
+              #     op_results = op.results
+              #     # Process the results.
+              #
+              #     metadata = op.metadata
+              #     # Process the metadata.
+              #   end
+              #
+              #   # Manually reload the operation.
+              #   operation.reload!
+              #
+              #   # Or block until the operation completes, triggering callbacks on
+              #   # completion.
+              #   operation.wait_until_done!
+
+              def restore_database \
+                  parent,
+                  database_id,
+                  backup: nil,
+                  options: nil
+                req = {
+                  parent: parent,
+                  database_id: database_id,
+                  backup: backup
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::RestoreDatabaseRequest)
+                operation = Google::Gax::Operation.new(
+                  @restore_database.call(req, options),
+                  @operations_client,
+                  Google::Spanner::Admin::Database::V1::Database,
+                  Google::Spanner::Admin::Database::V1::RestoreDatabaseMetadata,
+                  call_options: options
+                )
+                operation.on_done { |operation| yield(operation) } if block_given?
+                operation
+              end
+
+              # Lists database {Google::Longrunning::Operation longrunning-operations}.
+              # A database operation has a name of the form
+              # `projects/<project>/instances/<instance>/databases/<database>/operations/<operation>`.
+              # The long-running operation
+              # {Google::Longrunning::Operation#metadata metadata} field type
+              # `metadata.type_url` describes the type of the metadata. Operations returned
+              # include those that have completed/failed/canceled within the last 7 days,
+              # and pending operations.
+              #
+              # @param parent [String]
+              #   Required. The instance of the database operations.
+              #   Values are of the form `projects/<project>/instances/<instance>`.
+              # @param filter [String]
+              #   An expression that filters the list of returned operations.
+              #
+              #   A filter expression consists of a field name, a
+              #   comparison operator, and a value for filtering.
+              #   The value must be a string, a number, or a boolean. The comparison operator
+              #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
+              #   Colon `:` is the contains operator. Filter rules are not case sensitive.
+              #
+              #   The following fields in the {Google::Longrunning::Operation Operation}
+              #   are eligible for filtering:
+              #
+              #   * `name` - The name of the long-running operation
+              #     * `done` - False if the operation is in progress, else true.
+              #     * `metadata.@type` - the type of metadata. For example, the type string
+              #       for {Google::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata} is
+              #       `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`.
+              #     * `metadata.<field_name>` - any field in metadata.value.
+              #     * `error` - Error associated with the long-running operation.
+              #     * `response.@type` - the type of response.
+              #     * `response.<field_name>` - any field in response.value.
+              #
+              #     You can combine multiple expressions by enclosing each expression in
+              #     parentheses. By default, expressions are combined with AND logic. However,
+              #     you can specify AND, OR, and NOT logic explicitly.
+              #
+              #   Here are a few examples:
+              #
+              #   * `done:true` - The operation is complete.
+              #     * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` <br/>
+              #       `(metadata.source_type:BACKUP) AND` <br/>
+              #       `(metadata.backup_info.backup:backup_howl) AND` <br/>
+              #       `(metadata.name:restored_howl) AND` <br/>
+              #       `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` <br/>
+              #       `(error:*)` - Return operations where:
+              #       * The operation's metadata type is {Google::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata}.
+              #       * The database is restored from a backup.
+              #       * The backup name contains "backup_howl".
+              #       * The restored database's name contains "restored_howl".
+              #       * The operation started before 2018-03-28T14:50:00Z.
+              #       * The operation resulted in an error.
+              # @param page_size [Integer]
+              #   The maximum number of resources contained in the underlying API
+              #   response. If page streaming is performed per-resource, this
+              #   parameter does not affect the return value. If page streaming is
+              #   performed per-page, this determines the maximum number of
+              #   resources in a page.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @yield [result, operation] Access the result along with the RPC operation
+              # @yieldparam result [Google::Gax::PagedEnumerable<Google::Longrunning::Operation>]
+              # @yieldparam operation [GRPC::ActiveCall::Operation]
+              # @return [Google::Gax::PagedEnumerable<Google::Longrunning::Operation>]
+              #   An enumerable of Google::Longrunning::Operation instances.
+              #   See Google::Gax::PagedEnumerable documentation for other
+              #   operations such as per-page iteration or access to the response
+              #   object.
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #
+              #   # TODO: Initialize `filter`:
+              #   filter = ''
+              #
+              #   # Iterate over all results.
+              #   database_admin_client.list_database_operations(formatted_parent, filter).each do |element|
+              #     # Process element.
+              #   end
+              #
+              #   # Or iterate over results one page at a time.
+              #   database_admin_client.list_database_operations(formatted_parent, filter).each_page do |page|
+              #     # Process each page at a time.
+              #     page.each do |element|
+              #       # Process element.
+              #     end
+              #   end
+
+              def list_database_operations \
+                  parent,
+                  filter,
+                  page_size: nil,
+                  options: nil,
+                  &block
+                req = {
+                  parent: parent,
+                  filter: filter,
+                  page_size: page_size
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::ListDatabaseOperationsRequest)
+                @list_database_operations.call(req, options, &block)
+              end
+
+              # Lists the backup {Google::Longrunning::Operation long-running operations} in
+              # the given instance. A backup operation has a name of the form
+              # `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation>`.
+              # The long-running operation
+              # {Google::Longrunning::Operation#metadata metadata} field type
+              # `metadata.type_url` describes the type of the metadata. Operations returned
+              # include those that have completed/failed/canceled within the last 7 days,
+              # and pending operations. Operations returned are ordered by
+              # `operation.metadata.value.progress.start_time` in descending order starting
+              # from the most recently started operation.
+              #
+              # @param parent [String]
+              #   Required. The instance of the backup operations. Values are of
+              #   the form `projects/<project>/instances/<instance>`.
+              # @param filter [String]
+              #   An expression that filters the list of returned backup operations.
+              #
+              #   A filter expression consists of a field name, a
+              #   comparison operator, and a value for filtering.
+              #   The value must be a string, a number, or a boolean. The comparison operator
+              #   must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
+              #   Colon `:` is the contains operator. Filter rules are not case sensitive.
+              #
+              #   The following fields in the {Google::Longrunning::Operation operation}
+              #   are eligible for filtering:
+              #
+              #   * `name` - The name of the long-running operation
+              #     * `done` - False if the operation is in progress, else true.
+              #     * `metadata.@type` - the type of metadata. For example, the type string
+              #       for {Google::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} is
+              #       `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`.
+              #     * `metadata.<field_name>` - any field in metadata.value.
+              #     * `error` - Error associated with the long-running operation.
+              #     * `response.@type` - the type of response.
+              #     * `response.<field_name>` - any field in response.value.
+              #
+              #     You can combine multiple expressions by enclosing each expression in
+              #     parentheses. By default, expressions are combined with AND logic, but
+              #     you can specify AND, OR, and NOT logic explicitly.
+              #
+              #   Here are a few examples:
+              #
+              #   * `done:true` - The operation is complete.
+              #     * `metadata.database:prod` - The database the backup was taken from has
+              #       a name containing the string "prod".
+              #     * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` <br/>
+              #       `(metadata.name:howl) AND` <br/>
+              #       `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` <br/>
+              #       `(error:*)` - Returns operations where:
+              #       * The operation's metadata type is {Google::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
+              #       * The backup name contains the string "howl".
+              #       * The operation started before 2018-03-28T14:50:00Z.
+              #       * The operation resulted in an error.
+              # @param page_size [Integer]
+              #   The maximum number of resources contained in the underlying API
+              #   response. If page streaming is performed per-resource, this
+              #   parameter does not affect the return value. If page streaming is
+              #   performed per-page, this determines the maximum number of
+              #   resources in a page.
+              # @param options [Google::Gax::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout,
+              #   retries, etc.
+              # @yield [result, operation] Access the result along with the RPC operation
+              # @yieldparam result [Google::Gax::PagedEnumerable<Google::Longrunning::Operation>]
+              # @yieldparam operation [GRPC::ActiveCall::Operation]
+              # @return [Google::Gax::PagedEnumerable<Google::Longrunning::Operation>]
+              #   An enumerable of Google::Longrunning::Operation instances.
+              #   See Google::Gax::PagedEnumerable documentation for other
+              #   operations such as per-page iteration or access to the response
+              #   object.
+              # @raise [Google::Gax::GaxError] if the RPC is aborted.
+              # @example
+              #   require "google/cloud/spanner/admin/database"
+              #
+              #   database_admin_client = Google::Cloud::Spanner::Admin::Database.new(version: :v1)
+              #   formatted_parent = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdminClient.instance_path("[PROJECT]", "[INSTANCE]")
+              #
+              #   # TODO: Initialize `filter`:
+              #   filter = ''
+              #
+              #   # Iterate over all results.
+              #   database_admin_client.list_backup_operations(formatted_parent, filter).each do |element|
+              #     # Process element.
+              #   end
+              #
+              #   # Or iterate over results one page at a time.
+              #   database_admin_client.list_backup_operations(formatted_parent, filter).each_page do |page|
+              #     # Process each page at a time.
+              #     page.each do |element|
+              #       # Process element.
+              #     end
+              #   end
+
+              def list_backup_operations \
+                  parent,
+                  filter,
+                  page_size: nil,
+                  options: nil,
+                  &block
+                req = {
+                  parent: parent,
+                  filter: filter,
+                  page_size: page_size
+                }.delete_if { |_, v| v.nil? }
+                req = Google::Gax::to_proto(req, Google::Spanner::Admin::Database::V1::ListBackupOperationsRequest)
+                @list_backup_operations.call(req, options, &block)
+              end
             end
           end
         end