Visão geral
Nesta página, você vai aprender a usar a API Database Migration Service para gerenciar perfis de conexão de um banco de dados de origem do PostgreSQL e um destino do AlloyDB.
Há duas maneiras de usar a API Database Migration Service. É possível fazer chamadas da API REST ou usar a Google Cloud CLI.
Para ver informações gerais sobre como usar o gcloud
para gerenciar perfis de conexão do Database Migration Service, clique aqui.
Criar um perfil de conexão para um banco de dados de origem do PostgreSQL
O exemplo a seguir mostra uma solicitação para criar um perfil de conexão de um banco de dados de origem do PostgreSQL.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
- connection-profile-display-name: o nome de exibição do perfil de conexão
- host-ip-address: o endereço IP de origem
- username: o nome do usuário do banco de dados
- password: a senha do usuário do banco 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 da solicitação:
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "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 conferir informações gerais sobre como usar o gcloud
para criar perfis de conexão do Database Migration Service, clique aqui.
Após a criação, é possível conferir as informações sobre o perfil de conexão
chamando o método
connectionProfiles/get
.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
Método HTTP e URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
gcloud
Para saber como usar o gcloud
para recuperar informações sobre o perfil de conexão, clique aqui.
Criar um perfil de conexão para um banco de dados de origem do Cloud SQL para PostgreSQL
O exemplo a seguir mostra uma solicitação para criar um perfil de conexão de um banco de dados de origem do Cloud SQL para PostgreSQL. Este exemplo usa um perfil de conexão do PostgreSQL porque ele se conecta ao mecanismo de banco de dados do PostgreSQL, e não à camada de gerenciamento do Cloud SQL.
Para criar o pareamento entre a origem e a réplica usando o Cloud SQL, forneça o ID da instância do seu banco de dados do Cloud SQL. É possível encontrar o valor do ID da instância usando o método
databases/list
da API Cloud SQL Admin.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
- connection-profile-display-name: o nome de exibição do perfil de conexão
- host-ip-address: o endereço IP de origem
- username: o nome do usuário do banco de dados
- password: a senha do usuário do banco 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 da solicitação:
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "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 conferir informações gerais sobre como usar o gcloud
para criar perfis de conexão do Database Migration Service, clique aqui.
Criar um perfil de conexão para um destino do AlloyDB para PostgreSQL
O exemplo a seguir mostra uma solicitação para criar um perfil de conexão de um destino do AlloyDB para PostgreSQL. O Database Migration Service usa as informações desta solicitação para criar uma nova instância do AlloyDB.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
- connection-profile-display-name: o nome de exibição do perfil de conexão
- cluster-id: o ID do cluster do AlloyDB a ser criado
- user: o nome de usuário a ser atribuído ao usuário inicial
- password: a senha a ser fornecida ao usuário inicial
- vpc-network: a rede VPC à qual o cluster do AlloyDB será conectado
- instance-id: o ID da instância do AlloyDB a ser criado
- cpu-count: o número de CPUs para configurar a instância
Todos os dados armazenados no Google Cloud são criptografados em repouso usando os mesmos sistemas de gerenciamento de chaves protegidos que usamos para nossos próprios dados criptografados. Esses sistemas de gerenciamento de chaves fornecem controles de acesso e auditoria de chaves rigorosos e criptografam dados do usuário em repouso usando padrões de criptografia AES-256. Não é necessário fazer nenhuma configuração, configuração ou gerenciamento. A criptografia padrão do Google Cloudem repouso é a melhor opção para usuários que não têm requisitos específicos relacionados à conformidade ou à localização 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 da solicitação:
{ "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 a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "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 conferir informações gerais sobre como usar o gcloud
para criar perfis de conexão do Database Migration Service, clique aqui.
Receber informações sobre um perfil de conexão
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
Método HTTP e URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
gcloud
Para saber como usar o gcloud
para recuperar informações sobre o perfil de conexão, clique aqui.
Listar perfis de conexão
O código a seguir mostra uma solicitação para recuperar informações sobre todos os perfis de conexão.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
orderBy:
Use esse filtro para recuperar uma lista de todos os perfis de conexão de uma região específica em ordem alfabética. Por exemplo, o filtroorderBy=name
retorna todos os perfis de conexão, alfabeticamente, por nome.-
pageSize:
Use esse filtro para especificar o número máximo de perfis de conexão que o Database Migration Service recupera e exibe em uma página. Por exemplo, ao definirpageSize=10
, o Database Migration Service vai retornar até 10 perfis de conexão para uma página.
Se houver mais de 10 perfis de conexão, eles vão aparecer em outras páginas. No final de cada página, um parâmetro nextPageToken
e um identificador exclusivo aparecem. Use o identificador para extrair a lista dos perfis de conexão da página a seguir.
Método HTTP e URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
gcloud
Para saber como usar o gcloud
para recuperar informações sobre todos os seus perfis de conexão, clique aqui.
Atualizar um perfil de conexão
A seguir, mostramos uma solicitação para atualizar os campos de nome de usuário e senha de um perfil de conexão. Usando o parâmetro updateMask
na solicitação,
somente esses campos precisam ser incluídos no corpo da solicitação.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
- username: o nome do usuário do banco de dados
- password: a senha do usuário do banco de dados
Método HTTP e URL:
PATCH
Corpo JSON da solicitação:
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "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 saber como usar o gcloud
para atualizar seu perfil de conexão, clique aqui.
Excluir um perfil de conexão
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexão
Método HTTP e URL:
DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "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 o gcloud
para excluir seu perfil de conexão, clique aqui.
Excluir um perfil de conexão e a instância do AlloyDB associada
A seguir, mostramos uma solicitação para excluir um perfil de conexão de destino, além da exclusão em cascata da instância do AlloyDB associada.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- project-id: o ID do projeto
- region: a região do projeto
- connection-profile-id: o ID do perfil de conexã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 a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "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 o gcloud
para excluir seu perfil de conexão e a instância do AlloyDB associada, clique aqui.