Crea y administra bases de datos de PostgreSQL

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

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

Antes de comenzar

Antes de completar las tareas de esta página, debes haber hecho lo siguiente:

  • Crear una instancia de Cloud SQL. Para obtener más información, consulta Crea instancias.

Si planeas usar el cliente psql para crear o administrar tus bases de datos, debes haber hecho lo siguiente:

Crea una base de datos

Sigue las reglas en identificadores y palabras clave cuando crees el nombre de la base de datos. Si no se configuran durante la creación, las bases de datos nuevas tendrán los siguientes valores predeterminados:

  • Grupo de caracteres UTF8
  • Intercalación: en_US.UTF8

Para crear una base de datos en la instancia de Cloud SQL, haz lo siguiente:

Console

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

    Ir a la página Instancias de Cloud SQL

  2. Selecciona la instancia a la que deseas agregarle la base de datos.
  3. Selecciona la pestaña Bases de datos.
  4. Haga clic en Crear base de datos.
  5. En el cuadro de diálogo Nueva base de datos, especifica el nombre de la base de datos
    .
  6. Haz clic en Crear.

gcloud

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

Consulta los siguientes temas en la documentación de PostgreSQL para obtener información general y una lista de valores de grupos de caracteres compatibles:

gcloud sql databases create [DATABASE_NAME] --instance=[INSTANCE_NAME]
[--charset=CHARSET] [--collation=COLLATION]

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

  • 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://www.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 tu solicitud, expande una de estas opciones:

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

Cliente psql

Para obtener información de referencia, consulta crear base de datos en la documentación de PostgreSQL.

Consulta los siguientes temas en la documentación de PostgreSQL para obtener información general y una lista de valores de grupos de caracteres compatibles:

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

Haz una lista de tus bases de datos

Para hacer una lista de todas las bases de datos en una instancia, haz lo siguiente:

Console

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

    Ir a la página Instancias de Cloud SQL

  2. Selecciona la instancia para la que deseas hacer una lista de las bases de datos.
  3. Haz clic en Bases de datos.

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

gcloud

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

gcloud sql databases list --instance=[INSTANCE_NAME]

REST v1beta4

La siguiente solicitud usa el método databases:list para hacer una lista de las bases de datos de una instancia.

Cuando haces una lista de las bases de datos con la API, verás bases de datos de plantillas adicionales y una base de datos del sistema que la consola no muestra. No puedes borrar o administrar la base de datos del sistema.

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

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

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

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

Cliente psql

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

Cuando se enumeran las bases de datos mediante el cliente psql, se ven bases de datos de plantillas adicionales y una base de datos del sistema que no se muestran en la consola. No puedes borrar o administrar la base de datos del sistema.

\l

Borra una base de datos

Para borrar una base de datos en la instancia de Cloud SQL, haz lo siguiente:

Console

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

    Ir a la página Instancias de Cloud SQL

  2. Selecciona la instancia que contiene la base de datos que deseas borrar.
  3. Haz clic en Bases de datos.
  4. En la lista de bases de datos, busca la base de datos que deseas borrar y haz clic en el ícono de la papelera.
  5. En el cuadro de diálogo Borrar base de datos, ingresa el nombre de la base de datos y, luego, haz clic en BORRAR.

gcloud

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

gcloud sql databases delete [DATABASE_NAME] --instance=[INSTANCE_NAME]

REST v1beta4

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

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

  • 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://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name

Para enviar tu solicitud, expande una de estas opciones:

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

Cliente psql

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

DROP DATABASE [database_name];

¿Qué sigue?

Pruébalo tú mismo

Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud SQL en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Probar Cloud SQL gratis