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/import/__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.
+"""Provides commands to import 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 Import(base.Group):
+  """Provides commands to import Cloud SQL instances."""
+  category = base.DATABASES_CATEGORY

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

@@ -0,0 +1,96 @@
+# -*- 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.
+"""Imports data into a Cloud SQL instance from a BAK file.
+
+Imports data into a Cloud SQL instance from a BAK backup file in Google Cloud
+Storage.
+"""
+
+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 flags
+from googlecloudsdk.command_lib.sql import import_util
+from googlecloudsdk.core.console import console_io
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Bak(base.Command):
+  """Import data into a Cloud SQL instance from a BAK file."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          textwrap.dedent("""\
+          {command} imports data into a Cloud SQL instance from a BAK backup
+          file in Google Cloud Storage. You should use a full backup file with a
+          single backup set.
+
+          For detailed help on importing data into Cloud SQL, refer to this
+          guide: https://cloud.google.com/sql/docs/sqlserver/import-export/importing
+          """),
+      'EXAMPLES':
+          textwrap.dedent("""\
+          To import data from the BAK file `my-bucket/my-export.bak` into the
+          database `my-database` in the Cloud SQL instance `my-instance`,
+          run:
+
+            $ {command} my-instance gs://my-bucket/my-export.bak --database=my-database
+
+          To import data from the encrypted BAK file `my-bucket/my-export.bak` into the database
+          `my-database` in the Cloud SQL instance `my-instance`, with the certificate
+          `gs://my-bucket/my-cert.crt`, private key `gs://my-bucket/my-key.key` and prompting for the
+          private key password,
+          run:
+
+            $ {command} my-instance gs://my-bucket/my-export.bak --database=my-database --cert-path=gs://my-bucket/my-cert.crt --pvk-path=gs://my-bucket/my-key.key --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.
+    """
+    import_util.AddBakImportFlags(
+        parser, filetype='BAK file', gz_supported=False, user_supported=False
+    )
+    flags.AddDatabase(
+        parser, flags.SQLSERVER_DATABASE_IMPORT_HELP_TEXT, required=True)
+    flags.AddEncryptedBakFlags(parser)
+    flags.AddBakImportStripedArgument(parser)
+    flags.AddBakImportNoRecoveryArgument(parser)
+    flags.AddBakImportRecoveryOnlyArgument(parser)
+    flags.AddBakImportBakTypeArgument(parser)
+    flags.AddBakImportStopAtArgument(parser)
+    flags.AddBakImportStopAtMarkArgument(parser)
+    flags.AddBakImportKeepEncryptedArgument(parser)
+
+  def Run(self, args):
+    """Runs the command to import into 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 import_util.RunBakImportCommand(args, client)

gcloud auth application-default login/google-cloud-sdk/lib/surface/sql/import/csv.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.
+"""Imports data into a Cloud SQL instance from a CSV file.
+
+Imports data into a Cloud SQL instance from a plain text file in a Google
+Cloud Storage bucket 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 arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.sql import flags
+from googlecloudsdk.command_lib.sql import import_util
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Sql(base.Command):
+  """Imports data into a Cloud SQL instance from a CSV file.
+
+  Imports data into a Cloud SQL instance from a plain text file in a Google
+  Cloud Storage bucket 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.
+    """
+    import_util.AddBaseImportFlags(parser, filetype='CSV')
+    flags.AddDatabase(
+        parser,
+        'The database (for example, guestbook) to which the import is made.',
+        required=True)
+    parser.add_argument(
+        '--table',
+        required=True,
+        help='The database table to import csv file into.')
+    parser.add_argument(
+        '--columns',
+        required=False,
+        type=arg_parsers.ArgList(min_length=1),
+        metavar='COLUMNS',
+        help='The columns to import from csv file. These correspond to actual '
+        'database columns to import. If not set, all columns from csv file '
+        'are imported to corresponding database columns.')
+    flags.AddQuoteArgument(parser)
+    flags.AddEscapeArgument(parser)
+    flags.AddFieldsDelimiterArgument(parser)
+    flags.AddLinesDelimiterArgument(parser)
+
+  def Run(self, args):
+    """Runs the command to import into the Cloud SQL instance."""
+    client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
+    return import_util.RunCsvImportCommand(args, client)

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

@@ -0,0 +1,80 @@
+# -*- 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.
+"""Imports data into a Cloud SQL instance from a SQL dump file.
+
+Imports data into a Cloud SQL instance from a SQL dump file in Google Cloud
+Storage.
+"""
+
+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 flags
+from googlecloudsdk.command_lib.sql import import_util
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+@base.DefaultUniverseOnly
+class Sql(base.Command):
+  """Imports data into a Cloud SQL instance from a SQL dump file."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          textwrap.dedent("""\
+          {command} imports data into a Cloud SQL instance from a SQL dump file
+          in Google Cloud Storage.
+
+          NOTE: Certain roles and permissions are required to import data into
+          Google Cloud SQL. For more information on importing data into Google
+          Cloud SQL see [Import a SQL dump file](https://cloud.google.com/sql/docs/mysql/import-export/import-export-sql#gcloud_1).
+
+          For detailed help on importing data into Cloud SQL, refer to this
+          guide: https://cloud.google.com/sql/docs/mysql/import-export/importing
+          """),
+      'EXAMPLES':
+          textwrap.dedent("""\
+          To import data from a SQL dump file into a database, `testdb`, on the
+          specified Cloud SQL instance `test-instance-1`, run:
+
+            $  gcloud sql import sql test-instance-1 gs://test-bucket/test-file.sql.gz --database=testdb
+          """),
+      }
+
+  @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.
+    """
+    import_util.AddBaseImportFlags(parser, filetype='MySQL dump')
+    flags.AddDatabase(parser, flags.DEFAULT_DATABASE_IMPORT_HELP_TEXT)
+    flags.AddParallelArgument(parser, operation='import')
+    flags.AddThreadsArgument(parser, operation='import')
+    flags.AddCleanImportArgument(parser)
+    flags.AddIfExistsImportsArgument(parser)
+
+  def Run(self, args):
+    """Runs the command to import into the Cloud SQL instance."""
+    client = api_util.SqlClient(api_util.API_VERSION_DEFAULT)
+    return import_util.RunSqlImportCommand(args, client)

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

@@ -0,0 +1,83 @@
+# -*- 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.
+"""Imports data into a Cloud SQL instance from a TDE file.
+
+Imports data into a Cloud SQL instance from a TDE backup file in Google Cloud
+Storage.
+"""
+
+
+import textwrap
+
+from googlecloudsdk.api_lib.sql import api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.sql import flags
+from googlecloudsdk.command_lib.sql import import_util
+from googlecloudsdk.core.console import console_io
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Tde(base.Command):
+  """Import TDE certificate into a Cloud SQL for SQL Server instance."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          textwrap.dedent("""\
+          {command} imports a TDE certificate into a Cloud SQL instance from a certificate file
+          in Google Cloud Storage.
+
+          For detailed help on importing data into Cloud SQL, refer to this
+          guide: https://cloud.google.com/sql/docs/sqlserver/import-export/importing
+          """),
+      'EXAMPLES':
+          textwrap.dedent("""\
+          To import a TDE certificate with the name `foo` and certificate path `my-bucket/my-cert.cert`
+          and private key path `my-bucket/my-key.pvk` and pvk password `my-pvk-password` into
+          the Cloud SQL instance `my-instance`,
+          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 import a TDE certificate with the name `foo` and certificate path `my-bucket/my-cert.cert`
+          and private key path `my-bucket/my-key.pvk` into
+          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 import into 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 import_util.RunTdeImportCommand(args, client)