Importa un archivo SQL

En esta página, se describe cómo importar datos desde un archivo SQL almacenado en un bucket de Cloud Storage a un clúster de AlloyDB para PostgreSQL. Los archivos SQL son archivos de texto sin formato con una secuencia de comandos de SQL.

Nota: Si migras una base de datos completa desde un servidor de base de datos compatible (local, en AWS o AlloyDB) a un clúster nuevo de AlloyDB, puedes usar Database Migration Service en lugar de exportar y, luego, importar los archivos. Si importas porque quieres crear un clúster nuevo desde el archivo importado, considera restablecer desde una copia de seguridad a un clúster diferente.

Puedes cancelar la importación de datos en clústeres de AlloyDB. Para obtener más información, consulta Cancela una operación de importación.

Cuando importes archivos de volcado de SQL, asegúrate de que la versión de PostgreSQL desde la que se creó el volcado sea compatible con la versión de PostgreSQL de tu instancia de AlloyDB. Es posible que la importación de un archivo de volcado de una versión superior a una inferior falle debido a una sintaxis de SQL incompatible.

Antes de comenzar

Antes de comenzar una operación de importación, haz lo siguiente:

• Asegúrate de que tu base de datos tenga la cuota de almacenamiento adecuada.
• Las operaciones de importación usan recursos de bases de datos, pero no interfieren en las operaciones normales de la base de datos, a menos que el clúster no cuente con el aprovisionamiento suficiente.

Roles y permisos obligatorios para importar a AlloyDB

Para importar datos de Cloud Storage a AlloyDB, el usuario que inicia la importación debe tener uno de los siguientes roles:

• El rol de administrador de AlloyDB
• Un rol personalizado que incluya los siguientes permisos:
  • alloydb.clusters.get
  • alloydb.clusters.import

Además, la cuenta de servicio del clúster de AlloyDB debe tener uno de los siguientes roles:

• El rol de IAM storage.objectViewer
• Un rol personalizado que incluya los siguientes permisos:
  • storage.objects.get

Si deseas obtener ayuda con los roles de IAM, consulta Identity and Access Management.

Nota: Los cambios que realices en los permisos y los roles de IAM pueden tardar unos minutos en aplicarse. Para obtener más información, consulta Propagación de cambios de acceso.

Importa un archivo SQL a clústeres de AlloyDB

Para importar datos a un clúster de AlloyDB con un archivo SQL, sigue estos pasos:

Console

1. Ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en el nombre de un clúster para abrir la página Descripción general de ese clúster.

3. Haz clic en Importar.

4. En Formato de archivo, selecciona SQL.

5. En Seleccionar archivo fuente, elige si quieres subir archivos desde tu computadora o seleccionar un archivo de una ubicación de Cloud Storage.

   1. Para subir un archivo desde tu computadora, haz lo siguiente:

      1. Selecciona Subir archivos de tu computadora.
      2. Haz clic en Explorar junto a Seleccionar archivo local para seleccionar un archivo SQL de tu máquina local.
      3. Haz clic en Explorar junto a Seleccionar ubicación de Cloud Storage para seleccionar una ubicación de Cloud Storage en la que se almacenará el archivo local subido.
      4. Haz clic en Subir para subir el archivo.

   2. Para seleccionar un archivo SQL que existe en un bucket de Cloud Storage, haz lo siguiente:

      1. Selecciona Seleccionar archivo de Google Cloud Storage.
      2. Haz clic en Explorar junto a bucket-name/file-name para seleccionar un archivo SQL de un bucket de Cloud Storage.

6. En el menú desplegable Base de datos, selecciona la base de datos a la que deseas importar los datos.

   Esto hace que AlloyDB ejecute la instrucción USE DATABASE antes de la importación. Si el archivo de volcado de SQL incluye una instrucción USE DATABASE, esta anula la base de datos que configuraste en la consola de Google Cloud .

7. Es opcional. Para especificar un usuario para la operación de importación, haz clic en Mostrar opciones de usuario y, luego, ingresa el nombre de usuario en el campo Usuario.

8. Para iniciar la operación de importación, haz clic en Importar.

Nota: Puedes importar un archivo comprimido .gz o sin comprimir .sql.

gcloud

1. Crea buckets de Cloud Storage.

2. Sube el archivo SQL a tu bucket. Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos.

3. Usa gcloud storage buckets add-iam-policy-binding para otorgar el storage.objectViewer rol de IAM a la cuenta de servicio del clúster de AlloyDB para el bucket:

   [e-mail]

   Realiza los siguientes reemplazos:

   • CLUSTER_NAME: el nombre del clúster
   • REGION: Es la región en la que se implementa el clúster de AlloyDB.
   • BUCKET_NAME: El nombre del bucket de Cloud Storage.
   • FILE_NAME: Es el nombre del archivo CSV.
   • DATABASE_NAME: Es el nombre de una base de datos dentro del clúster.
   • USER: Es el usuario de la operación de importación.
   • TABLE_NAME: Es la tabla dentro de la base de datos.

   Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.

4. Importa el archivo:

   gcloud alloydb clusters import CLUSTER_NAME --region=REGION --database=DATABASE_NAME --gcs-uri='gs://BUCKET_NAME/PATH_TO_SQL_FILE' --user=USERNAME --sql

   Nota: Puedes importar un archivo comprimido (.gz) o uno sin comprimir (.sql).

   Si el comando muestra un error como PERMISSION_DENIED, revisa los permisos.

   Para obtener información sobre el uso del comando import, consulta la página de referencia del comando alloydb import.

5. Si no necesitas conservar los permisos de IAM que configuraste antes, quítalos a través de gcloud storage buckets remove-iam-policy-binding.

REST v1

1. Crea buckets de Cloud Storage.
2. Sube el archivo SQL a tu bucket. Para obtener ayuda con la carga de archivos en buckets, consulta Sube objetos.

3. Otorga permisos a la cuenta de servicio para el bucket de Cloud Storage para la operación de importación. Usa el formato de la cuenta de servicio para identificar la cuenta de servicio del proyecto al que importas. El formato de la cuenta de servicio es el siguiente:

   [e-mail]

4. Usa gcloud storage buckets add-iam-policy-binding para otorgar el storage.objectViewer rol de IAM a la cuenta de servicio del clúster de AlloyDB para el bucket. Para obtener ayuda con la configuración de permisos de IAM, consulta Usa permisos de IAM.

5. Importa tu archivo SQL.

   Nota: Puedes importar un archivo comprimido (.gz) o uno sin comprimir (.sql).

   Usa el siguiente método y URL de HTTP:

   POST https://alloydbadmin.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import

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

   • PROJECT_ID: Es el ID del proyecto.
   • LOCATION_ID: Es la región en la que se implementa el clúster de AlloyDB.
   • CLUSTER_ID: Es el ID del clúster.
   • BUCKET_NAME: El nombre del bucket de Cloud Storage.
   • PATH_TO_SQL_FILE: Es la ruta de acceso al archivo SQL.
   • USER: Es el usuario que se usará para la importación.
   • DATABASE_NAME: Es el nombre de una base de datos dentro del clúster de AlloyDB.

   Cuerpo JSON de la solicitud:

   {
      "gcsUri": "gs://BUCKET_NAME/PATH_TO_SQL_FILE",
      "database": "DATABASE_NAME",
      "user": "USER",
      "sqlImportOptions": {}
   }
   

   Para enviar tu solicitud, expande una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Con el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

   PowerShell (Windows)

   Con el siguiente comando, se supone que accediste a Google Cloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

   $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://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"| Select-Object -Expand Content
   

   Recibirás una respuesta JSON similar a la siguiente:

   Respuesta

   {
    "name": "projects/project-id/locations/location-id/operations/operation-id",
    "metadata": {
     "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
     "createTime": "2025-01-04T13:12:32.363393723Z",
     "target": "projects/project-id/locations/location-id/clusters/cluster-id",
     "verb": "import",
     "requestedCancellation": false,
     "apiVersion": "v1"
    },
    "done": false
   }
   

   Si quieres usar un usuario diferente para la importación, especifica la propiedad del usuario.

6. Si no necesitas conservar los permisos de IAM que configuraste antes, quítalos ahora.

   Si quieres obtener la lista completa de los parámetros de esta solicitud, consulta clusters:import.

Cómo verificar el estado de una operación de importación

Para verificar el estado de una operación de importación, sigue estos pasos:

gcloud

Ejecuta lo siguiente con el comando gcloud alloydb operations describe:

gcloud alloydb operations describe OPERATION_ID --region=REGION

También puedes enumerar detalles de una operación específica o cancelar una operación específica. Para obtener más información sobre este comando, consulta la página de referencia del comando gcloud alloydb operations.

REST v1

Usa el método GET y la siguiente URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

Para obtener más información, consulta get.

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

• REGION: Es la región en la que se implementa el clúster de AlloyDB.
• PROJECT_ID: Es el ID del proyecto.
• OPERATION_ID: Es el ID de la operación de importación. Para obtener más información, consulta Antes de comenzar.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

  curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID
 

PowerShell (Windows)

Con el siguiente comando, se supone que accediste a la gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID | Select-Object -Expand Content

Recibirás una respuesta JSON similar a la siguiente:

Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de Operation.

¿Qué sigue?

• Obtén más información para importar un archivo CSV.
• Obtén más información para cancelar una operación de importación.