Esta página foi traduzida pela API Cloud Translation.

Faça a gestão dos perfis de associação através da API

MySQL | PostgreSQL | PostgreSQL para AlloyDB

Vista geral

Nesta página, vai saber como usar a API Database Migration Service para gerir perfis de ligação para uma base de dados de origem do PostgreSQL e um destino do AlloyDB.

Existem duas formas de usar a API Database Migration Service. Pode fazer chamadas à API REST ou usar a CLI (interface de linha de comandos) do Google Cloud.

Para ver informações de alto nível sobre a utilização da gcloud para gerir perfis de ligação do serviço de migração de bases de dados, clique aqui.

Crie um perfil de associação para uma base de dados de origem do PostgreSQL

O exemplo seguinte mostra um pedido para criar um perfil de ligação para uma base de dados de origem do PostgreSQL.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação
connection-profile-display-name: o nome a apresentar do perfil de associação
host-ip-address: O endereço IP de origem
username: o nome de utilizador da base de dados
password: a palavra-passe do utilizador da base de dados

Método HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Corpo JSON do pedido:

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para ver informações de nível elevado sobre a utilização do gcloud para criar perfis de ligação do serviço de migração de bases de dados, clique aqui.

Após a criação, pode ver as informações sobre o seu perfil de associação chamando o método connectionProfiles/get.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação

Método HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

gcloud

Para mais informações sobre a utilização do gcloud para obter informações sobre o seu perfil de associação, clique aqui.

Crie um perfil de associação para uma base de dados de origem do Cloud SQL para PostgreSQL

O exemplo seguinte mostra um pedido para criar um perfil de ligação para uma base de dados de origem do Cloud SQL para PostgreSQL. Este exemplo usa um perfil de ligação do PostgreSQL porque se liga ao motor de base de dados do PostgreSQL e não à camada de gestão do Cloud SQL.

Para criar a sincronização entre a origem e a réplica através do Cloud SQL, tem de indicar o ID da instância da base de dados do Cloud SQL. Pode encontrar o valor do ID da instância através do método databases/list da API Cloud SQL Admin.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação
connection-profile-display-name: o nome a apresentar do perfil de associação
host-ip-address: O endereço IP de origem
username: o nome de utilizador da base de dados
password: a palavra-passe do utilizador da base de dados
cloud-sql-instance-id: o ID da instância do Cloud SQL

Método HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Corpo JSON do pedido:

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para ver informações de nível elevado sobre a utilização do gcloud para criar perfis de ligação do serviço de migração de bases de dados, clique aqui.

Crie um perfil de ligação para um destino do AlloyDB for PostgreSQL

O exemplo seguinte mostra um pedido para criar um perfil de ligação para um destino do AlloyDB para PostgreSQL. O serviço de migração de bases de dados usa as informações nesta solicitação para criar uma nova instância do AlloyDB.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação
connection-profile-display-name: o nome a apresentar do perfil de associação
cluster-id: o ID do cluster do AlloyDB a criar
user: o nome de utilizador a atribuir ao utilizador inicial
password: a palavra-passe a dar ao utilizador inicial
vpc-network: a rede VPC à qual o cluster do AlloyDB vai estar ligado
instance-id: o ID da instância do AlloyDB a criar
cpu-count: o número de CPUs com que configurar a instância

Todos os dados armazenados no Google Cloud são encriptados em repouso através dos mesmos sistemas de gestão de chaves reforçados que usamos para os nossos próprios dados encriptados. Estes sistemas de gestão de chaves oferecem controlos de acesso e auditoria de chaves rigorosos, e encriptam os dados do utilizador em repouso através de normas de encriptação AES-256. Não é necessária configuração nem gestão.A encriptação em repouso predefinida do Google Cloudé a melhor escolha para os utilizadores que não têm requisitos específicos relacionados com a conformidade ou a localidade do material criptográfico.

Método HTTP e URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Corpo JSON do pedido:

{
  "displayName": "connection-profile-display-name",
  "alloydb": {
    "cluster_id": "cluster-id"
    "settings": {
      "initial_user": {
        "user": "user",
        "password": "password",
      }
      "vpc_network": "vpc-network",
      "primary_instance_settings": {
        "id": "instance-id",
        "machine_config": {
          "cpu_count": cpu-count
        }
      }
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para ver informações de nível elevado sobre a utilização do gcloud para criar perfis de ligação do serviço de migração de bases de dados, clique aqui.

Receba informações sobre um perfil de associação

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação

Método HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

gcloud

Para mais informações sobre a utilização do gcloud para obter informações sobre o seu perfil de associação, clique aqui.

Apresentar perfis de ligação

O exemplo seguinte mostra um pedido para obter informações sobre todos os seus perfis de ligação.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto

Também pode filtrar a lista de perfis de ligação que o Database Migration Service obtém da seguinte forma:

orderBy: Use este filtro para obter uma lista de todos os perfis de associação de uma determinada região por ordem alfabética. Por exemplo, o filtro orderBy=name devolve todos os perfis de ligação, por ordem alfabética, por nome.
pageSize: Use este filtro para especificar o número máximo de perfis de ligação que o serviço de migração de bases de dados obtém e apresenta numa página. Por exemplo, ao definir pageSize=10, o serviço de migração de bases de dados devolve até 10 perfis de ligação para uma página.

Se existirem mais de 10 perfis de ligação, estes aparecem noutras páginas. No final de cada página, é apresentado um parâmetro nextPageToken e um identificador exclusivo. Use o identificador para obter a ficha dos perfis de associação para a página seguinte.

Método HTTP e URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles"

PowerShell (Windows)

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

gcloud

Para mais informações sobre a utilização de gcloud para obter informações sobre todos os seus perfis de ligação, clique aqui.

Atualize um perfil de associação

O exemplo seguinte mostra um pedido para atualizar os campos de nome de utilizador e palavra-passe de um perfil de ligação existente. Ao usar o parâmetro updateMask no pedido, apenas estes campos têm de ser incluídos no corpo do pedido.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação
username: o nome de utilizador da base de dados
password: a palavra-passe do utilizador da base de dados

Método HTTP e URL:

PATCH

Corpo JSON do pedido:

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     ""

PowerShell (Windows)

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para mais informações sobre como usar o gcloud para atualizar o seu perfil de ligação, clique aqui.

Elimine um perfil de ligação

Importante: só pode eliminar um perfil de associação se não existirem tarefas de migração ativas associadas ao perfil. Se um perfil de ligação tiver tarefas de migração ativas, promova ou elimine as tarefas.

Para ver se um perfil de associação tem tarefas de migração ativas associadas, execute o seguinte comando:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?filter=state:STATE_NAME OR state:STATE_NAME AND source:projects/project-id/locations/region/connectionProfiles/connection-profile-id

Por exemplo:

GET https://datamigration.googleapis.com/v1/projects/myproject/locations/myregion/migrationJobs?filter=state:RUNNING OR state:FAILED AND source:projects/myproject/locations/myregion/connectionProfiles/postgresql-to-alloydb-src1

Os vários estados da tarefa de migração são:

NOT STARTED: A tarefa de migração é criada, mas não é iniciada.
STARTING: A tarefa de migração está a ser iniciada.
RUNNING: A tarefa de migração está em execução e pode ser usada para migrar dados da base de dados de origem para a base de dados de destino.
STOPPING: A tarefa de migração está em processo de paragem.
STOPPED: A tarefa de migração está em pausa e já não está a migrar dados para a base de dados de destino.
RESUMING: A tarefa de migração pausada está em execução.
FAILED: Ocorreu um problema durante a execução da tarefa de migração.
RESTARTING: O serviço de migração de bases de dados tira uma nova captura instantânea da base de dados de origem, carrega o despejo inicial na base de dados de destino e processa as alterações contínuas de dados da base de dados de origem para a base de dados de destino.

Se um utilizador tiver uma tarefa de migração num destes estados e tentar eliminar o perfil de ligação, a ação falha.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação

Método HTTP e URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para mais informações sobre como usar gcloud para eliminar o seu perfil de ligação, clique aqui.

Elimine um perfil de ligação e a instância do AlloyDB associada

O exemplo seguinte mostra um pedido para eliminar um perfil de ligação de destino, bem como a eliminação em cascata da instância do AlloyDB associada.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

project-id: o ID do projeto
region: a região do projeto
connection-profile-id: o ID do perfil de associação

Método HTTP e URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true"

PowerShell (Windows)

Execute o seguinte comando:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Para mais informações sobre como usar gcloud para eliminar o seu perfil de ligação e a instância do AlloyDB associada, clique aqui.

Faça a gestão dos perfis de associação através da API Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Vista geral

Crie um perfil de associação para uma base de dados de origem do PostgreSQL

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Crie um perfil de associação para uma base de dados de origem do Cloud SQL para PostgreSQL

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Crie um perfil de ligação para um destino do AlloyDB for PostgreSQL

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Receba informações sobre um perfil de associação

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Apresentar perfis de ligação

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Atualize um perfil de associação

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Elimine um perfil de ligação

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Elimine um perfil de ligação e a instância do AlloyDB associada

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

gcloud

Faça a gestão dos perfis de associação através da API