Exportar um arquivo CSV

gcloud

1. Crie um bucket do Cloud Storage.

2. Conceda à conta de serviço permissões no bucket do Cloud Storage para a operação de exportação. Use o formato da conta de serviço para identificar a conta de serviço do projeto de onde você está exportando. O formato da conta de serviço é:

   service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

3. Use gcloud storage buckets add-iam-policy-binding para conceder o storage.objectAdmin papel do IAM à conta de serviço. Para ajuda com a configuração de permissões do IAM, consulte Como usar as permissões do Cloud IAM.

4. Exporte o banco de dados para o bucket do Cloud Storage.

   Execute o comando de exportação de CSV: gcloud alloydb clusters export.

   A tabela a seguir lista as opções para exportar dados em formato CSV:

   • --select-query (obrigatório): a consulta de seleção usada para extrair os dados.
   • --async (opcional): retorna imediatamente, sem aguardar a conclusão da operação em andamento.
   • --field-delimiter (opcional): especifica o caractere que separa as colunas em cada linha do arquivo. O padrão é uma vírgula. O valor desse argumento precisa ser um caractere no código ASCII hexadecimal.
   • --quote-character (opcional): especifica o caractere de aspas a ser usado quando um valor de dados é colocado entre aspas. O padrão é uma aspa dupla. O valor desse argumento precisa ser um caractere no código ASCII hexadecimal.
   • --escape-character (opcional): especifica o caractere que precisa aparecer antes de um caractere de dados que precisa de escape. O padrão é o mesmo que --quote-character. O valor desse argumento precisa ser um caractere no código ASCII hexadecimal.

   Para usar esses recursos, inclua as opções no comando da CLI gcloud.

   Caso contrário, remova esses parâmetros do comando:

   gcloud alloydb clusters export CLUSTER_NAME
     --region=REGION
     --database=DATABASE_NAME
     --gcs-uri="gs://BUCKET_NAME/OBJECT_NAME"
     --select-query=SELECT_QUERY
     --field-delimiter=FIELD_DELIMITER
     --quote-character=QUOTE_CHARACTER
     --escape-character=ESCAPE_CHARACTER
     --csv

5. Se você não precisar manter o papel do IAM definido anteriormente, revogue agora.

REST v1

1. Crie um bucket para a exportação:

   gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME>

2. Use o formato da conta de serviço para identificar a conta do projeto de origem.

   O formato da conta de serviço é:

    service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

   Ele precisa receber permissões para o bucket do Cloud Storage na operação de exportação.

3. Use gcloud storage buckets add-iam-policy-binding para conceder o papel do IAM storage.objectAdmin à conta de serviço. Para ajuda com a configuração de permissões do IAM, consulte Como usar as permissões do Cloud IAM.

4. Exporte o banco de dados.
   

   Use o método HTTP e o URL a seguir:

   POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:export

   Antes de usar os dados da solicitação, faça as substituições a seguir:

   • PROJECT_ID: o ID do projeto;
   • REGION: a região em que o cluster do AlloyDB é implantado.
   • CLUSTER_ID: o ID do cluster.
   • BUCKET_NAME: o nome do bucket do Cloud Storage.
   • PATH_TO_CSV_FILE: o caminho para o arquivo CSV.
   • DATABASE_NAME: o nome de um banco de dados dentro do cluster do AlloyDB.

   • SELECT_QUERY: a consulta SQL para a exportação.

   • ESCAPE_CHARACTER (opcional): o caractere que precisa aparecer antes de um caractere de dados que precisa de escape. O valor desse argumento precisa ser um caractere no código ASCII hexadecimal. Por exemplo, 22 representa aspas duplas.

   • QUOTE_CHARACTER (opcional): o caractere que inclui valores de colunas com um tipo de dados de string. O valor desse argumento precisa ser um caractere no código ASCII hexadecimal. Por exemplo, 22 representa aspas duplas.

   • FIELD_DELIMITER (opcional): o caractere que divide os valores da coluna. O valor desse argumento precisa ser um caractere no código ASCII hexadecimal. Por exemplo, 2C representa uma vírgula.

   Solicitar corpo JSON:

   {
     "gcs_destination": {
       "uri": "gs://BUCKET_NAME/PATH_TO_CSV_FILE"
     },
     "database": "DATABASE_NAME",
     "csv_export_options": {
       "select_query": "SELECT_QUERY",
       "escape_character": "ESCAPE_CHARACTER",
       "quote_character": "QUOTE_CHARACTER",
       "field_delimiter": "FIELD_DELIMITER"
     }
   }
   

   Para enviar a solicitação, use uma destas opções:

       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/REGION/clusters/CLUSTER_ID:export"
  

    $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/REGION/clusters/CLUSTER_ID:export"| Select-Object -Expand Content
  

Você vai receber uma resposta JSON semelhante a esta:

    {
     "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
     "metadata": {
      "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
      "createTime": "2024-09-17T06:05:31.244428646Z",
      "target": "projects/PROJECT_ID/locations/REGION/clusters/TARGET_CLUSTER",
      "verb": "export",
      "requestedCancellation": false,
      "apiVersion": "v1"
     },
     "done": false
    }
  

Se você não precisar manter as permissões do IAM definidas anteriormente, remova-as agora.

Para ver a lista completa de parâmetros da solicitação, consulte clusters:export.