Use a API Database Migration Service

Vista geral

O serviço de migração de base de dados fornece uma API REST para administrar os seus perfis de ligação e tarefas de migração de forma programática. A API REST é definida por recursos associados à criação e gestão de perfis de associação e tarefas de migração. Para ver detalhes sobre todos os recursos e respetivos métodos, consulte a referência da API Database Migration Service.

Quando envia pedidos diretamente para a API REST do Database Migration Service, tem de criar a forma correta do pedido, autorizar o pedido como um utilizador autenticado e processar todas as respostas devolvidas. Muitas das tarefas nesta documentação fornecem exemplos de API com o cURL.

Para ver mais exemplos de utilização das APIs, consulte a página do pedido na referência da API Database Migration Service. Cada página tem exemplos que chamam a API em várias linguagens de programação, bem como um explorador específico do pedido para ajudar a ver o que é incluído num pedido bem formado e o que esperar na resposta.

Também está a usar a API Database Migration Service, indiretamente, quando usa qualquer uma das seguintes formas de administrar instâncias:

• CLI do Google Cloud: uma interface de linhas de comando (CLI) que pode usar para trabalhar com as suas instâncias.

• Google Cloud console: Uma interface Web gráfica.

A vantagem de usar estes métodos, especialmente a Google Cloud consola, é que podem simplificar bastante a administração dos seus perfis de ligação e tarefas de migração (consoante o seu exemplo de utilização). Se está a começar a usar o serviço de migração de bases de dados, recomendamos que comece por usar uma destas ferramentas antes de trabalhar diretamente com a API REST.

Ative a API

Para usar a API Database Migration Service, tem de a ativar:

Autorizações

Tem de ter as autorizações necessárias para usar a API Database Migration Service. Estas autorizações incluem:

• Administrador da migração de bases de dados: com esta autorização, um utilizador ganha acesso a todos os recursos do serviço de migração de bases de dados usados para gerir perfis de ligação e tarefas de migração.
• Visualizador da migração de bases de dados: com esta autorização, um utilizador tem acesso só de leitura a perfis de ligação e tarefas de migração no Database Migration Service.
• Administrador do Cloud SQL: com esta autorização, um utilizador pode criar e gerir perfis de ligação e tarefas de migração para o Cloud SQL no serviço de migração de base de dados.

O Google Cloud oferece a gestão de identidade e de acesso (IAM), que lhe permite conceder um acesso mais detalhado a recursos específicos do Google Cloud e impede o acesso indesejado a outros recursos. Pode obter e definir autorizações para o serviço de migração de bases de dados através da Google Cloud console, dos métodos IAM da API ou da CLI Google Cloud. Para mais informações, consulte o artigo Conceder, alterar e revogar o acesso a recursos.

Exemplos de APIs

Para ver exemplos de utilização da API Database Migration Service com o cURL, consulte os artigos Faça a gestão de perfis de ligação através da API e Faça a gestão de tarefas de migração através da API.

Forneça dados JSON a partir de um ficheiro

Quando usa a API com o cURL, fornece valores de propriedades através da linha de comandos. Se estiver a trabalhar com valores confidenciais, como palavras-passe ou chaves de segurança, fornecê-los na linha de comandos representa um risco de segurança. Para aumentar a segurança, pode criar um ficheiro que contenha os dados JSON para a chamada API e fornecer o caminho para o ficheiro na linha de comandos.

Para fornecer dados JSON à sua chamada da API cURL a partir de um ficheiro:

1. Crie um ficheiro que contenha tudo o que está entre aspas simples para o campo --data.

   Inclua as chavetas, mas não inclua as aspas simples.

2. Na linha de comandos, indique o caminho para o ficheiro, precedido pelo caráter @, como o parâmetro --data:

   --data @<path-to-file>/<filename>

   Por exemplo, para criar um perfil de ligação para uma base de dados de origem do Cloud SQL, pode criar um ficheiro denominado request.json com o seguinte conteúdo:

   {
     "displayName": "my Cloud SQL connection profile",
     "mysql": {
       "host": "10.11.12.13",
       "port": 3306,
       "username": "myusername",
       "password": "mypassword"
     }
   }
   

   Em seguida, usaria o seguinte comando cURL na linha de comandos:

   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data @./request.json \
        -X POST \
        https://datamigration.googleapis.com/v1/projects/myProject/locations/myLocation/connectionProfiles?connectionProfileId=myCloudSQLconnectionprofile

Trabalhe com chamadas de API de execução prolongada

Algumas chamadas API, como a criação de objetos, podem demorar algum tempo a ser concluídas. Uma vez que a API é assíncrona, a chamada é devolvida imediatamente, mesmo que a operação ainda esteja em curso. Se uma chamada de API subsequente usar o objeto recém-criado, tem de aguardar que a primeira operação seja concluída antes de continuar.

Pode usar a API Database Migration Service para gerir operações. Isto inclui:

• A mostrar detalhes sobre uma operação
• Apresentar operações para uma região
• Eliminar uma operação

Database Migration Service e Google APIs Discovery Service

O serviço Google APIs Discovery é um serviço que pode usar para descobrir APIs Google. Por exemplo, quando usa a ferramenta Google APIs Explorer , está a usar o serviço Discovery.

No serviço de deteção, o serviço de migração de bases de dados é representado como "datamigration" (por exemplo: https://datamigration.googleapis.com/$discovery/rest?version=v1).