docs(samples): Add samples for Cloud Spanner Default Backup Schedules (#1238)

* chore(samples): Add samples for Cloud Spanner Default Backup Schedules * chore(samples): Add samples for Cloud Spanner Default Backup Schedules Fix field name in code samples. * chore(samples): Add samples for Cloud Spanner Default Backup Schedules Fix field name in code samples. --------- Co-authored-by: Sri Harsha CH <57220027+harshachinta@users.noreply.github.com>

Author: Sally-Ye

samples/samples/requirements.txt

@@ -1,2 +1,2 @@
-google-cloud-spanner==3.49.1
+google-cloud-spanner==3.50.0
 futures==3.4.0; python_version < "3"

samples/samples/snippets.py

@@ -3222,6 +3222,57 @@ def create_instance_with_autoscaling_config(instance_id):
 # [END spanner_create_instance_with_autoscaling_config]
 
 
+# [START spanner_create_instance_without_default_backup_schedule]
+def create_instance_without_default_backup_schedules(instance_id):
+ spanner_client = spanner.Client()
+ config_name = "{}/instanceConfigs/regional-me-central2".format(
+ spanner_client.project_name
+ )
+
+ operation = spanner_client.instance_admin_api.create_instance(
+ parent=spanner_client.project_name,
+ instance_id=instance_id,
+ instance=spanner_instance_admin.Instance(
+ config=config_name,
+ display_name="This is a display name.",
+ node_count=1,
+ default_backup_schedule_type=spanner_instance_admin.Instance.DefaultBackupScheduleType.NONE, # Optional
+ ),
+ )
+
+ print("Waiting for operation to complete...")
+ operation.result(OPERATION_TIMEOUT_SECONDS)
+
+ print("Created instance {} without default backup schedules".format(instance_id))
+
+
+# [END spanner_create_instance_without_default_backup_schedule]
+
+
+# [START spanner_update_instance_default_backup_schedule_type]
+def update_instance_default_backup_schedule_type(instance_id):
+ spanner_client = spanner.Client()
+
+ name = "{}/instances/{}".format(spanner_client.project_name, instance_id)
+
+ operation = spanner_client.instance_admin_api.update_instance(
+ instance=spanner_instance_admin.Instance(
+ name=name,
+ default_backup_schedule_type=spanner_instance_admin.Instance.DefaultBackupScheduleType.AUTOMATIC, # Optional
+ ),
+ field_mask=field_mask_pb2.FieldMask(
+ paths=["default_backup_schedule_type"]
+ ),
+ )
+
+ print("Waiting for operation to complete...")
+ operation.result(OPERATION_TIMEOUT_SECONDS)
+
+ print("Updated instance {} to have default backup schedules".format(instance_id))
+
+# [END spanner_update_instance_default_backup_schedule_type]
+
+
 def add_proto_type_columns(instance_id, database_id):
  # [START spanner_add_proto_type_columns]
  # instance_id = "your-spanner-instance"

samples/samples/snippets_test.py

@@ -197,6 +197,25 @@ def test_create_instance_with_autoscaling_config(capsys, lci_instance_id):
  retry_429(instance.delete)()
 
 
+def test_create_and_update_instance_default_backup_schedule_type(capsys, lci_instance_id):
+ retry_429(snippets.create_instance_without_default_backup_schedules)(
+ lci_instance_id,
+ )
+ create_out, _ = capsys.readouterr()
+ assert lci_instance_id in create_out
+ assert "without default backup schedules" in create_out
+
+ retry_429(snippets.update_instance_default_backup_schedule_type)(
+ lci_instance_id,
+ )
+ update_out, _ = capsys.readouterr()
+ assert lci_instance_id in update_out
+ assert "to have default backup schedules" in update_out
+ spanner_client = spanner.Client()
+ instance = spanner_client.instance(lci_instance_id)
+ retry_429(instance.delete)()
+
+
 def test_create_instance_partition(capsys, instance_partition_instance_id):
  # Unable to use create_instance since it has editions set where partitions are unsupported.
  # The minimal requirement for editions is ENTERPRISE_PLUS for the paritions to get supported.