Crear y administrar bases de datos.

Esta página contiene información sobre cómo crear, enumerar y eliminar bases de datos PostgreSQL en una instancia de Cloud SQL.

Una instancia recién creada tiene una base de datos postgres .

Para obtener más información sobre las bases de datos PostgreSQL, consulte la documentación de PostgreSQL .

Antes de empezar

Antes de completar las tareas de esta página, debes tener:

Si planea utilizar el cliente psql para crear o administrar sus bases de datos, debe tener:

Crear una base de datos en la instancia de Cloud SQL

Consola

  1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
  3. Seleccione Bases de datos en el menú de navegación de SQL.
  4. Haga clic en Crear base de datos .
  5. En el cuadro de diálogo Nueva base de datos , especifique el nombre de la base de datos.
  6. Haga clic en Crear .

nube g

Para obtener información de referencia, consulte gcloud sql databases create .

gcloud sql databases create DATABASE_NAME \
--instance=INSTANCE_NAME

Terraformar

Para crear una base de datos, utilice un recurso Terraform . 

resource "google_sql_database" "database" {
  name     = "my-database"
  instance = google_sql_database_instance.instance.name
}

Aplicar los cambios

Para aplicar su configuración de Terraform en un Google Cloud proyecto, complete los pasos de las siguientes secciones.

Preparar Cloud Shell

  1. Inicie Cloud Shell .

  2. Establecer el valor predeterminado Google Cloud Proyecto donde desea aplicar sus configuraciones de Terraform.

    Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Las variables de entorno se anulan si establece valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz ).

  1. En Cloud Shell , cree un directorio y un nuevo archivo dentro de él. El nombre del archivo debe tener la extensión .tf ; por ejemplo, main.tf En este tutorial, el archivo se denomina main.tf 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Si está siguiendo un tutorial, puede copiar el código de muestra en cada sección o paso.

    Copie el código de muestra en el main.tf recién creado.

    Opcionalmente, copie el código de GitHub. Esto se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

  3. Revise y modifique los parámetros de muestra para aplicarlos a su entorno.
  4. Guarde sus cambios.
  5. Inicialice Terraform. Solo necesita hacerlo una vez por directorio.
    terraform init

    Opcionalmente, para utilizar la última versión del proveedor de Google, incluya la opción -upgrade :

    terraform init -upgrade

Aplicar los cambios

  1. Revise la configuración y verifique que los recursos que Terraform va a crear o actualizar coincidan con sus expectativas:
    terraform plan

    Realice correcciones en la configuración según sea necesario.

  2. Aplique la configuración de Terraform ejecutando el siguiente comando e ingresando yes en el indicador:
    terraform apply

    Espere hasta que Terraform muestre el mensaje "¡Aplicación completada!"

  3. Abre tu Google Cloud proyecto para ver los resultados. En el Google Cloud consola, navegue a sus recursos en la interfaz de usuario para asegurarse de que Terraform los haya creado o actualizado.

Eliminar los cambios

Para eliminar sus cambios, haga lo siguiente:

  1. Para deshabilitar la protección contra eliminación, en el archivo de configuración de Terraform configure el argumento deletion_protection en false . 
    deletion_protection =  "false"
  2. Aplique la configuración actualizada de Terraform ejecutando el siguiente comando e ingresando yes en el mensaje: 
    terraform apply

  1. Elimine los recursos aplicados previamente con su configuración de Terraform ejecutando el siguiente comando e ingresando yes en el mensaje: 

    terraform destroy

REST versión 1

La siguiente solicitud utiliza el método databases:insert para crear una nueva base de datos en la instancia especificada.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • project-id : El ID del proyecto
  • instance-id : El ID de la instancia
  • database-name : el nombre de una base de datos dentro de la instancia de Cloud SQL

Método HTTP y URL: 

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

Cuerpo JSON de la solicitud: 

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "database-name"
}

Para enviar su solicitud, expanda una de estas opciones:

Debería recibir una respuesta JSON similar a la siguiente:

REST v1beta4

La siguiente solicitud utiliza el método databases:insert para crear una nueva base de datos en la instancia especificada.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • project-id : El ID del proyecto
  • instance-id : El ID de la instancia
  • database-name : el nombre de una base de datos dentro de la instancia de Cloud SQL

Método HTTP y URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

Cuerpo JSON de la solicitud: 

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "database-name"
}

Para enviar su solicitud, expanda una de estas opciones:

Debería recibir una respuesta JSON similar a la siguiente:

Cliente psql

Para obtener información de referencia, consulte CREATE DATABASE en la documentación de PostgreSQL.

Consulte los siguientes temas en la documentación de PostgreSQL para obtener información general y una lista de valores de conjuntos de caracteres admitidos:

CREATE DATABASE database_name
  [[ ENCODING encoding ][ LC_COLLATE lc_collate ]];

Por ejemplo:
CREATE DATABASE "example_db" WITH OWNER "example_user" ENCODING 'UTF8' LC_COLLATE = 'pl_PL.utf8' LC_CTYPE = 'pl_PL.utf8' TEMPLATE template0;

Enumere sus bases de datos

Para enumerar todas las bases de datos en una instancia:

Consola

  1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
  3. Haga clic en Bases de datos en el menú lateral izquierdo. La página Bases de datos muestra las bases de datos junto con su tipo de intercalación, conjunto de caracteres y tipo de base de datos.

nube g

Para obtener información de referencia, consulte gcloud sql databases list . 

gcloud sql databases list \
--instance=INSTANCE_NAME

REST versión 1

La siguiente solicitud utiliza el método databases:list para enumerar las bases de datos de una instancia.

Al listar las bases de datos mediante la API, se ven bases de datos de plantilla adicionales y una base de datos del sistema que no se muestran en la consola. No se puede eliminar ni administrar la base de datos del sistema.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • project-id : El ID del proyecto
  • instance-id : El ID de la instancia

Método HTTP y URL: 

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

Para enviar su solicitud, expanda una de estas opciones:

Debería recibir una respuesta JSON similar a la siguiente:

REST v1beta4

La siguiente solicitud utiliza el método databases:list para enumerar las bases de datos de una instancia.

Al listar las bases de datos mediante la API, se ven bases de datos de plantilla adicionales y una base de datos del sistema que no se muestran en la consola. No se puede eliminar ni administrar la base de datos del sistema.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • project-id : El ID del proyecto
  • instance-id : El ID de la instancia

Método HTTP y URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

Para enviar su solicitud, expanda una de estas opciones:

Debería recibir una respuesta JSON similar a la siguiente:

Cliente psql

Para obtener información de referencia, consulte la lista .

Al listar las bases de datos con el cliente psql , se ven bases de datos de plantilla adicionales y una base de datos del sistema que no se muestran en la consola. No se puede eliminar ni administrar la base de datos del sistema. 

\l

Eliminar una base de datos

Para eliminar una base de datos en la instancia de Cloud SQL:

Consola

  1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
  3. Haga clic en Bases de datos en el menú del lado izquierdo.
  4. En la lista de bases de datos, busque la base de datos que desea eliminar y haga clic en el ícono de la papelera.
  5. En el cuadro de diálogo Eliminar base de datos , ingrese el nombre de la base de datos y luego haga clic en Eliminar .

nube g

Para obtener información de referencia, consulte gcloud sql databases delete . 

gcloud sql databases delete DATABASE_NAME \
--instance=INSTANCE_NAME

REST versión 1

La siguiente solicitud utiliza el método databases:delete para eliminar la base de datos especificada.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • project-id : El ID del proyecto
  • instance-id : El ID de la instancia
  • database-name : el nombre de una base de datos dentro de la instancia de Cloud SQL

Método HTTP y URL: 

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name

Para enviar su solicitud, expanda una de estas opciones:

Debería recibir una respuesta JSON similar a la siguiente:

REST v1beta4

La siguiente solicitud utiliza el método databases:delete para eliminar la base de datos especificada.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • project-id : El ID del proyecto
  • instance-id : El ID de la instancia
  • database-name : el nombre de una base de datos dentro de la instancia de Cloud SQL

Método HTTP y URL: 

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name

Para enviar su solicitud, expanda una de estas opciones:

Debería recibir una respuesta JSON similar a la siguiente:

Cliente psql

Para obtener información de referencia, consulte DROP DATABASE en la documentación de PostgreSQL. 

DROP DATABASE [database_name];

¿Qué sigue?

Pruébelo usted mismo

Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud SQL en situaciones reales. Los nuevos clientes también reciben $300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.

Pruebe Cloud SQL gratis