.TH "GCLOUD_SQL_CONNECT" 1



.SH "NAME"
.HP
gcloud sql connect \- connects to a Cloud SQL instance



.SH "SYNOPSIS"
.HP
\f5gcloud sql connect\fR \fIINSTANCE\fR [\fB\-\-database\fR=\fIDATABASE\fR,\ \fB\-d\fR\ \fIDATABASE\fR] [\fB\-\-user\fR=\fIUSER\fR,\ \fB\-u\fR\ \fIUSER\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Connects to a Cloud SQL instance.

This command temporarily changes the authorized networks for this instance to
allow the connection from your IP address.

This command isn't supported for Cloud SQL instances with only private IP
addresses.

NOTE: If you're connecting from an IPv6 address, or are constrained by certain
organization policies (restrictPublicIP, restrictAuthorizedNetworks), consider
running the beta version of this command to avoid error by connecting through
the Cloud SQL proxy: \fBgcloud beta sql connect\fR



.SH "EXAMPLES"

To connect to a Cloud SQL instance, run:

.RS 2m
$ gcloud sql connect my\-instance \-\-user=root
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIINSTANCE\fR

Cloud SQL instance ID.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-database\fR=\fIDATABASE\fR, \fB\-d\fR \fIDATABASE\fR

The SQL Server database to connect to.

.TP 2m
\fB\-\-user\fR=\fIUSER\fR, \fB\-u\fR \fIUSER\fR

Cloud SQL instance user to connect as.


.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"

These variants are also available:

.RS 2m
$ gcloud alpha sql connect
.RE

.RS 2m
$ gcloud beta sql connect
.RE