110 lines
4.2 KiB
Python
110 lines
4.2 KiB
Python
# -*- coding: utf-8 -*- #
|
|
# Copyright 2016 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.
|
|
"""Command for spanner databases create."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import unicode_literals
|
|
|
|
import textwrap
|
|
|
|
from googlecloudsdk.api_lib.spanner import database_operations
|
|
from googlecloudsdk.api_lib.spanner import databases
|
|
from googlecloudsdk.calliope import base
|
|
from googlecloudsdk.command_lib.spanner import flags
|
|
from googlecloudsdk.command_lib.spanner import resource_args
|
|
|
|
|
|
class Create(base.CreateCommand):
|
|
"""Create a Cloud Spanner database."""
|
|
|
|
detailed_help = {
|
|
'EXAMPLES':
|
|
textwrap.dedent("""\
|
|
To create an empty Cloud Spanner database, run:
|
|
|
|
$ {command} testdb --instance=my-instance-id
|
|
|
|
To create a Cloud Spanner database with populated schema, run:
|
|
|
|
$ {command} testdb --instance=my-instance-id
|
|
--ddl='CREATE TABLE mytable (a INT64, b INT64) PRIMARY KEY(a)'
|
|
|
|
To create a Cloud Spanner database with the PostgreSQL dialect, run:
|
|
|
|
$ {command} testdb --instance=my-instance-id
|
|
--database-dialect=POSTGRESQL
|
|
"""),
|
|
}
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
"""See base class."""
|
|
resource_args.AddDatabaseResourceArg(parser, 'to create')
|
|
flags.Ddl(help_text='Semi-colon separated DDL (data definition language) '
|
|
'statements to run inside the '
|
|
'newly created database. If there is an error in any statement, '
|
|
'the database is not created. This option is not supported for '
|
|
'the PostgreSQL dialect. Full DDL specification is at '
|
|
'https://cloud.google.com/spanner/docs/data-definition-language'
|
|
).AddToParser(parser)
|
|
flags.DdlFile(
|
|
help_text='Path of a file that contains semi-colon separated DDL (data '
|
|
'definition language) statements to run inside the newly created '
|
|
'database. If there is an error in any statement, the database is not '
|
|
'created. This option is not supported for the PostgreSQL dialect. '
|
|
'Full DDL specification is at '
|
|
'https://cloud.google.com/spanner/docs/data-definition-language.'
|
|
' If --ddl_file is set, --ddl is ignored. One line comments starting '
|
|
'with -- are ignored.').AddToParser(parser)
|
|
flags.ProtoDescriptorsFile(
|
|
help_text='Path of a file that contains a protobuf-serialized '
|
|
'google.protobuf.FileDescriptorSet message. To generate it, install and'
|
|
' run `protoc` with --include_imports and --descriptor_set_out.'
|
|
).AddToParser(parser)
|
|
base.ASYNC_FLAG.AddToParser(parser)
|
|
parser.display_info.AddCacheUpdater(flags.DatabaseCompleter)
|
|
resource_args.AddKmsKeyResourceArg(parser,
|
|
'to create the Cloud Spanner database')
|
|
flags.DatabaseDialect(
|
|
help_text='The SQL dialect of the Cloud Spanner Database. '
|
|
'GOOGLE_STANDARD_SQL is the default.'
|
|
).AddToParser(parser)
|
|
|
|
def Run(self, args):
|
|
"""This is what gets called when the user runs this command.
|
|
|
|
Args:
|
|
args: an argparse namespace. All the arguments that were provided to this
|
|
command invocation.
|
|
|
|
Returns:
|
|
Some value that we want to have printed later.
|
|
"""
|
|
database_ref = args.CONCEPTS.database.Parse()
|
|
instance_ref = database_ref.Parent()
|
|
kms_key_name_or_names = resource_args.GetAndValidateKmsKeyName(args)
|
|
op = databases.Create(
|
|
instance_ref,
|
|
args.database,
|
|
flags.SplitDdlIntoStatements(args),
|
|
flags.GetProtoDescriptors(args),
|
|
kms_key_name_or_names,
|
|
args.database_dialect,
|
|
)
|
|
if args.async_:
|
|
return op
|
|
return database_operations.Await(op, 'Creating database')
|