feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/sql/export/__init__.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# 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
+#
+#    http://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.
+"""Provide commands to export Cloud SQL instances."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Export(base.Group):
+  """Provide commands to export Cloud SQL instances."""
+  category = base.DATABASES_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/sql/export/bak.py

@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 Google LLC. All Rights Reserved.
+#
+# 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
+#
+#    http://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.
+"""Export data from a Cloud SQL instance to a BAK file.
+
+Export data from a Cloud SQL instance to a Google Cloud Storage bucket as
+a BAK backup file.
+"""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import textwrap
+
+from googlecloudsdk.api_lib.sql import api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.sql import export_util
+from googlecloudsdk.command_lib.sql import flags
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(
+    base.ReleaseTrack.GA, base.ReleaseTrack.BETA, base.ReleaseTrack.ALPHA
+)
+class Bak(base.Command):
+  """Export data from a Cloud SQL instance to a BAK file.
+
+  Export data from a Cloud SQL instance to a Google Cloud Storage
+  bucket as a BAK backup file. This is only supported for SQL Server.
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+          To export data from the database `my-database` in the Cloud SQL
+          instance `my-instance` to a BAK file `my-bucket/my-export.bak`,
+          run:
+
+            $ {command} my-instance gs://my-bucket/my-export.bak --database=my-database
+          """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    export_util.AddBaseExportFlags(
+        parser,
+        gz_supported=False,
+        database_required=True,
+        database_help_text=flags.SQLSERVER_DATABASE_LIST_EXPORT_HELP_TEXT)
+    flags.AddBakExportStripeCountArgument(parser)
+    flags.AddBakExportStripedArgument(parser)
+    flags.AddBakExportBakTypeArgument(parser)
+    flags.AddBakExportDifferentialBaseArgument(parser)
+    flags.AddBakExportLogStartTimeArgument(parser)
+    flags.AddBakExportLogEndTimeArgument(parser)
+
+  def Run(self, args):
+    """Runs the command to export the Cloud SQL instance."""
+    client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
+    return export_util.RunBakExportCommand(args, client)

gcloud auth application-default login/google-cloud-sdk/lib/surface/sql/export/csv.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# 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
+#
+#    http://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.
+"""Exports data from a Cloud SQL instance to a CSV file.
+
+Exports data from a Cloud SQL instance to a Google Cloud Storage bucket as a
+plain text file with one line per row and comma-separated fields.
+"""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.sql import api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.sql import export_util
+from googlecloudsdk.command_lib.sql import flags
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Csv(base.Command):
+  """Exports data from a Cloud SQL instance to a CSV file.
+
+  Exports data from a Cloud SQL instance to a Google Cloud Storage bucket as a
+  plain text file with one line per row and comma-separated fields.
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go
+          on the command line after this command. Positional arguments are
+          allowed.
+    """
+    export_util.AddBaseExportFlags(parser)
+    flags.AddOffloadArgument(parser)
+    parser.add_argument(
+        '--query',
+        required=True,
+        help='A SQL SELECT query (e.g., SELECT * FROM table) that specifies '
+             'the data to export. WARNING: While in-transit, the query might '
+             'be processed in intermediate locations other than the location '
+             'of the target instance.')
+    flags.AddQuoteArgument(parser)
+    flags.AddEscapeArgument(parser)
+    flags.AddFieldsDelimiterArgument(parser)
+    flags.AddLinesDelimiterArgument(parser)
+
+  def Run(self, args):
+    """Runs the command to export the Cloud SQL instance."""
+    client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
+    return export_util.RunCsvExportCommand(args, client)

gcloud auth application-default login/google-cloud-sdk/lib/surface/sql/export/sql.py

@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# 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
+#
+#    http://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.
+"""Exports data from a Cloud SQL instance to a SQL file.
+
+Exports data from a Cloud SQL instance to a Google Cloud Storage bucket as
+a SQL dump file.
+"""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.sql import api_util
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.sql import export_util
+from googlecloudsdk.command_lib.sql import flags
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class Sql(base.Command):
+  # pylint: disable=line-too-long
+  """Exports data from a Cloud SQL instance to a SQL file.
+
+  Exports data from a Cloud SQL instance to a Google Cloud Storage
+  bucket as a SQL dump file.
+
+  NOTE: Certain roles and permissions are required to export data to Google
+  Cloud Storage. For more information on exporting data from Google Cloud SQL
+  see [Export from Cloud SQL to a SQL dump file](https://cloud.google.com/sql/docs/mysql/import-export/import-export-sql#gcloud).
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go
+          on the command line after this command. Positional arguments are
+          allowed.
+    """
+    export_util.AddBaseExportFlags(parser)
+    flags.AddOffloadArgument(parser)
+    flags.AddParallelArgument(parser, operation='export')
+    flags.AddThreadsArgument(parser, operation='export')
+    flags.AddCleanExportArgument(parser)
+    flags.AddIfExistsExportsArgument(parser)
+    parser.add_argument(
+        '--table',
+        '-t',
+        type=arg_parsers.ArgList(min_length=1),
+        metavar='TABLE',
+        required=False,
+        help='Tables to export from the specified database. If you specify '
+        'tables, specify one and only one database. For PostgreSQL instances, '
+        'only one table can be exported at a time.')
+
+  def Run(self, args):
+    """Runs the command to export the Cloud SQL instance."""
+    client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
+    return export_util.RunSqlExportCommand(args, client)

gcloud auth application-default login/google-cloud-sdk/lib/surface/sql/export/tde.py

@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 Google LLC. All Rights Reserved.
+#
+# 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
+#
+#    http://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.
+"""Export TDE certificate from a Cloud SQL for SQL Server instance.
+
+Export data from a Cloud SQL instance to a Google Cloud Storage bucket as
+a BAK backup file.
+"""
+
+
+import textwrap
+
+from googlecloudsdk.api_lib.sql import api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.sql import export_util
+from googlecloudsdk.command_lib.sql import flags
+from googlecloudsdk.core.console import console_io
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Tde(base.Command):
+  """Export a TDE certificate from a Cloud SQL for SQL Server instance.
+
+  Exports a TDE certificate from a Cloud SQL instance to a Google Cloud Storage
+  bucket. This is only supported for SQL Server.
+  """
+
+  detailed_help = {
+      'EXAMPLES':
+          textwrap.dedent("""\
+          To export a TDE certificate with the name `foo` and private key password `my-pvk-password` in the Cloud SQL
+          instance `my-instance` to certificate path `my-bucket/my-cert.cert` and private key path `my-bucket/my-key.pvk`,
+          run:
+
+            $ {command} my-instance --certificate=foo --cert-path=gs://my-bucket/my-cert.cert --pvk-path=gs://my-bucket/my-key.pvk --pvk-password=my-pvk-password
+
+          To export a TDE certificate with the name `foo` and private key password `my-pvk-password` in the Cloud SQL
+          instance `my-instance` and prompting for the private key password,
+          run:
+
+            $ {command} my-instance --certificate=foo --cert-path=gs://my-bucket/my-cert.cert --pvk-path=gs://my-bucket/my-key.pvk --prompt-for-pvk-password
+
+          """),
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Args is called by calliope to gather arguments for this command.
+
+    Args:
+      parser: An argparse parser that you can use to add arguments that go on
+        the command line after this command. Positional arguments are allowed.
+    """
+    base.ASYNC_FLAG.AddToParser(parser)
+    flags.AddInstanceArgument(parser)
+    flags.AddTdeFlags(parser)
+
+  def Run(self, args):
+    """Runs the command to export the Cloud SQL instance."""
+    if args.prompt_for_pvk_password:
+      args.pvk_password = console_io.PromptPassword('Private Key Password: ')
+
+    client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
+    return export_util.RunTdeExportCommand(args, client)