.TH "GCLOUD_BETA_SPANNER_DATABASES_SPLITS_ADD" 1



.SH "NAME"
.HP
gcloud beta spanner databases splits add \- add split points to a  Spanner database



.SH "SYNOPSIS"
.HP
\f5gcloud beta spanner databases splits add\fR (\fIDATABASE\fR\ :\ \fB\-\-instance\fR=\fIINSTANCE\fR) \fB\-\-splits\-file\fR=\fISPLITS_FILE\fR [\fB\-\-initiator\fR=\fIINITIATOR\fR] [\fB\-\-split\-expiration\-date\fR=\fISPLIT_EXPIRATION_DATE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Add split points to a Spanner database.



.SH "EXAMPLES"

To add split points to the given Spanner database, run:

.RS 2m
$ gcloud beta spanner databases splits add my\-database\-id \e
    \-\-instance=my\-instance\-id \-\-splits\-file=path/to/splits.txt \e
    \-\-initiator=my\-initiator\-string \e
    \-\-split\-expiration\-date=2024\-08\-15T15:55:10Z
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Database resource \- The Cloud Spanner database on which to add split points.
The arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5database\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIDATABASE\fR

ID of the database or fully qualified identifier for the database.

To set the \f5database\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5database\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-instance\fR=\fIINSTANCE\fR

The Cloud Spanner instance for the database.

To set the \f5instance\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5database\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-instance\fR on the command line;
.IP "\(bu" 2m
set the property \f5spanner/instance\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-splits\-file\fR=\fISPLITS_FILE\fR

The path of a file containing split points to add to the database. Separate
split points in the file with a new line. The file format is
<ObjectType>[space]<ObjectName>[space]<Split Value>, where the ObjectType is one
of TABLE or INDEX and the Split Value is the split point key. For index, the
split point key is the index key with or without a full table key prefix.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-initiator\fR=\fIINITIATOR\fR

The tag to identify the initiator of the split points.

.TP 2m
\fB\-\-split\-expiration\-date\fR=\fISPLIT_EXPIRATION_DATE\fR

The date when the split points become system managed and becomes eligible for
merging. The default is 10 days from the date of creation. The maximum is 30
days from the date of creation.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud spanner databases splits add
.RE

.RS 2m
$ gcloud alpha spanner databases splits add
.RE