Crea una instancia

Console

1. Ve a la página Instancias de Cloud SQL en la consola de Google Cloud.

   Ir a Instancias de Cloud SQL

2. Haz clic en Crear instancia.
3. En el panel Elige tu motor de base de datos de la página Crear una instancia, haz clic en Elegir SQL Server.

4. En la sección Elige una edición de Cloud SQL de la página Crea una instancia de SQL Server, selecciona la edición de Cloud SQL para tu instancia: Enterprise o Enterprise plus.

   Para obtener más información acerca de las ediciones de Cloud SQL, consulta Introducción a las ediciones de Cloud SQL para SQL Server.

5. Selecciona el ajuste predeterminado de edición para tu instancia. Para ver los ajustes predeterminados disponibles, haz clic en el menú Configuración predeterminada de edición.
6. En la sección Información de la instancia, selecciona la versión de base de datos de tu instancia. Para ver las versiones disponibles, haz clic en el menú Versión de la base de datos.
7. En el campo ID de instancia, ingresa un ID para la instancia.

   No debes incluir el ID del proyecto en el nombre de la instancia. Esto se hace de manera automática cuando es apropiado (por ejemplo, en los archivos de registro).

8. En el campo Contraseña, ingresa una contraseña para el usuario raíz.
9. En la sección Elige la región y la disponibilidad zonal, selecciona la región y la zona para la instancia.

   Ubica la instancia en la misma región en la que están los recursos que acceden a ella. No se podrá modificar la región que seleccionaste en un futuro. En la mayoría de los casos, no necesitas especificar una zona.

10. En la sección Personaliza tu instancia, actualiza la configuración de la instancia. Por ejemplo, puedes evitar la eliminación accidental de instancias.
11. Haz clic en Crear instancia.
12. Una vez que se complete el proceso de inicialización de la instancia, haz clic en su nombre para abrirla.

gcloud

Para obtener información sobre cómo instalar y comenzar a usar la CLI de gcloud, consulta Instala la CLI de gcloud. Si quieres obtener información para iniciar Cloud Shell, consulta la Documentación de Cloud Shell.

Debes usar la versión gcloud 243.0.0 o una posterior.

Para obtener información sobre cómo proteger una instancia contra la eliminación accidental, consulta Evita la eliminación de una instancia.

1. Crea la instancia:
   Para las instancias de edición de Cloud SQL Enterprise Plus, ejecuta el siguiente comando:

   gcloud sql instances create INSTANCE_NAME \
   --database-version=DATABASE_VERSION \
   --region=REGION \
   --tier=TIER \
   --root-password=ROOT_PASSWORD \
   --edition=ENTERPRISE_PLUS

   Para las instancias de edición de Cloud SQL Enterprise, ejecuta el siguiente comando:

   gcloud sql instances create INSTANCE_NAME \
   --database-version=DATABASE_VERSION \
   --region=REGION \
   --cpu=NUMBER_OF_vCPUs \
   --memory=MEMORY_SIZE \
   --root-password=ROOT_PASSWORD \
   --edition=ENTERPRISE

   No debes incluir el ID del proyecto en el nombre de la instancia. Esto se hace de manera automática cuando es apropiado (por ejemplo, en los archivos de registro).

   Como se mencionó antes en esta página, los valores de CPU virtuales y de tamaño de memoria son limitados para la edición Enterprise de Cloud SQL. Consulta Elige entre Cloud SQL edición Enterprise Plus y Cloud SQL edición Enterprise.

   Por ejemplo, la siguiente string crea una instancia con dos CPU virtuales y 7,680 MB de memoria:

   gcloud sql instances create myinstance \
   --database-version=SQLSERVER_2017_STANDARD \
   --region=us-central1 \
   --cpu=2 \
   --memory=7680MB \
   --root-password=EXAMPLE_PASSWORD \
   --edition=ENTERPRISE

   Para obtener algunos valores de muestra, consulta Tipos de máquina de muestra.

   Para obtener más información sobre la configuración de las instancias, consulta gcloud sql instances create.

2. Anota la dirección IP que se asignó de manera automática.

   Si no usas el proxy de Cloud SQL Auth, usarás esta dirección como dirección de host que tus aplicaciones o herramientas usarán para conectarse a la instancia.

3. Configura la contraseña para el usuario:

   gcloud sql users set-password sqlserver no-host --instance=[INSTANCE_NAME] \
          --password=[PASSWORD]

Terraform

Para crear una instancia, usa un recurso de Terraform.

resource "google_sql_database_instance" "instance" {
  name             = "sqlserver-instance"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

REST v1

1. Crea la instancia

No todos los campos posibles se muestran en la siguiente llamada a la API básica. Para obtener el prototipo de una solicitud JSON, consulta Configuración.

Consulta también la página Instances:insert. Para obtener información sobre la configuración de las instancias, incluidos los valores válidos por región, consulta Configuración de instancias. Para obtener información sobre los tipos de máquina, consulta Configuración de instancias personalizadas.

No incluyas información sensible o de identificación personal en instance-id, ya que el valor es visible de forma externa.

No debes incluir el ID del proyecto en el nombre de la instancia. Esto se hace de manera automática cuando es apropiado (por ejemplo, en los archivos de registro).

El campo collation (que no aparece en la siguiente llamada a la API básica) te permite establecer un valor predeterminado para el tipo de intercalación que se usa en las bases de datos de tu instancia. Esta configuración predeterminada de intercalación es permanente a nivel de la instancia, pero no a nivel de la base de datos. Puedes cambiar esta configuración predeterminada con una herramienta de administración de bases de datos, pero solo para una base de datos específica que estés creando o actualizando. No puedes cambiar la configuración predeterminada de intercalación de una instancia después de crearla (a menos que la vuelvas a crear). Para obtener información sobre las intercalaciones en SQL Server, consulta Compatibilidad de la intercalación y Unicode. Para obtener el prototipo de una solicitud JSON, consulta Configuración. En este ejemplo, se muestra una string que puedes especificar para el parámetro collation: SQL_Latin1_General_CP1_CI_AS.

El campo timeZone (que no aparece en la siguiente llamada a la API básica) te permite establecer una zona horaria para una instancia. Después de crear una instancia, puedes cambiar su zona horaria. Para obtener más información y una lista de cadenas aceptadas, consulta Configuración. En este ejemplo, se muestra una string que puedes especificar para el parámetro timeZone: "Pacific Standard Time". Ver más.

Para crear una instancia que esté integrada con Microsoft AD administrado, especifica un dominio, como subdomain.mydomain.com, en el campo domain. Para obtener más información, consulta Crea una instancia con Windows Authentication. Además, ten en cuenta los procedimientos y restricciones para la integración con un dominio de AD administrado en un proyecto diferente.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el ID de tu proyecto
• INSTANCE_ID: El ID de la instancia.
• REGION: Es el nombre de la región.
• DATABASE_VERSION: la string de enum de la versión de la base de datos. Por ejemplo: SQLSERVER_2017_STANDARD.
• PASSWORD: la contraseña del usuario root.
• MACHINE_TYPE: Es una cadena de enum del tipo de máquina (nivel). Por ejemplo:
  db-perf-optimized-N-4.
• EDITION_TYPE: tu edición de Cloud SQL. El valor predeterminado es ENTERPRISE.
• DATA_CACHE_ENABLED: (opcional) a fin de habilitar la caché de datos para tu instancia, establece el valor de este parámetro en true.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Cuerpo JSON de la solicitud:

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "backupConfiguration": {
      "enabled": true
    },
    "dataCacheConfig" = {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Después de crear la instancia, puedes configurar la cuenta de usuario predeterminada.

2. Recupera la dirección IPv4 de la instancia

De manera opcional, puedes recuperar la dirección IPv4 asignada automáticamente. En la respuesta, esa dirección está en el campo ipAddress.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: El ID de tu proyecto
• INSTANCE_ID: Es el ID de la instancia, que creaste en el paso anterior.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Para enviar tu solicitud, expande una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "DATABASE_VERSION",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "MACHINE_TYPE",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "ZONE",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "19:00",
      "kind": "sql#backupConfiguration",
      "enabled": true
    },
    "settingsVersion": "1",
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "PROJECT_ID",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "BACKEND_TYPE",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "connectionName": "PROJECT_ID:REGION:INSTANCE_ID",
  "name": "INSTANCE_ID",
  "region": "REGION",
  "gceZone": "ZONE"
}

REST v1beta4

1. Crea la instancia

No todos los campos posibles se muestran en la siguiente llamada a la API básica. Para obtener el prototipo de una solicitud JSON, consulta Configuración.

Consulta también la página Instances:insert. Para obtener información sobre la configuración de las instancias, incluidos los valores válidos por región, consulta Configuración de instancias. Para obtener información sobre los tipos de máquina, consulta Configuración de instancias personalizadas.

No incluyas información sensible o de identificación personal en instance-id, ya que el valor es visible de forma externa.

No debes incluir el ID del proyecto en el nombre de la instancia. Esto se hace de manera automática cuando es apropiado (por ejemplo, en los archivos de registro).

El campo collation (que no aparece en la siguiente llamada a la API básica) te permite establecer un valor predeterminado para el tipo de intercalación que se usa en las bases de datos de tu instancia. Esta configuración predeterminada de intercalación es permanente a nivel de la instancia, pero no a nivel de la base de datos. Puedes cambiar esta configuración predeterminada con una herramienta de administración de bases de datos, pero solo para una base de datos específica que estés creando o actualizando. No puedes cambiar la configuración predeterminada de intercalación de una instancia después de crearla (a menos que la vuelvas a crear). Para obtener información sobre las intercalaciones en SQL Server, consulta Compatibilidad de la intercalación y Unicode. Para obtener el prototipo de una solicitud JSON, consulta Configuración. En este ejemplo, se muestra una string que puedes especificar para el parámetro collation: SQL_Latin1_General_CP1_CI_AS.

El campo timeZone (que no aparece en la siguiente llamada a la API básica) te permite establecer una zona horaria para una instancia. Después de crear una instancia, puedes cambiar su zona horaria. Para obtener más información y una lista de cadenas aceptadas, consulta Configuración. En este ejemplo, se muestra una string que puedes especificar para el parámetro timeZone: "Pacific Standard Time". Ver más.

Para crear una instancia que esté integrada con Microsoft AD administrado, especifica un dominio, como subdomain.mydomain.com, en el campo domain. Para obtener más información, consulta Crea una instancia con Windows Authentication. Además, ten en cuenta los procedimientos y restricciones para la integración con un dominio de AD administrado en un proyecto diferente.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el ID de tu proyecto
• INSTANCE_ID: El ID de la instancia.
• REGION: Es el nombre de la región.
• DATABASE_VERSION: la string de enum de la versión de la base de datos.
• MACHINE_TYPE: Es una cadena de enum del tipo de máquina (nivel). Por ejemplo:
  db-perf-optimized-N-4.
• PASSWORD: la contraseña del usuario root.
• MACHINE_TYPE: una cadena de enum del tipo de máquina (nivel) como: db-custom-[CPUS]-[MEMORY_MBS].
• EDITION_TYPE: tu edición de Cloud SQL. El valor predeterminado es ENTERPRISE.
• DATA_CACHE_ENABLED: (opcional) a fin de habilitar la caché de datos para tu instancia, establece el valor de este parámetro en true.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

Cuerpo JSON de la solicitud:

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "backupConfiguration": {
      "enabled": true
    },
    "dataCacheConfig" = {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Después de crear la instancia, puedes configurar la cuenta de usuario predeterminada.

2. Recupera la dirección IPv4 de la instancia

De manera opcional, puedes recuperar la dirección IPv4 asignada automáticamente. En la respuesta, esa dirección está en el campo ipAddress.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: El ID de tu proyecto
• INSTANCE_ID: Es el ID de la instancia, que creaste en el paso anterior.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Para enviar tu solicitud, expande una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "DATABASE_VERSION",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "MACHINE_TYPE",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "ZONE",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "19:00",
      "kind": "sql#backupConfiguration",
      "enabled": true
    },
    "settingsVersion": "1",
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "PROJECT_ID",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "BACKEND_TYPE",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "connectionName": "PROJECT_ID:REGION:INSTANCE_ID",
  "name": "INSTANCE_ID",
  "region": "REGION",
  "gceZone": "ZONE"
}