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 que usam 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 consola: 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:
Consola
- Ative a API Database Migration Service.
- Selecione o seu projeto.
- Selecione Continuar.
gcloud
- Introduza o seguinte para apresentar os IDs dos seus Google Cloud
projetos:
gcloud projects list
- Defina o projeto predefinido:
gcloud config set project YOUR_PROJECT_ID
- Ative a API Admin do Cloud SQL:
gcloud services enable datamigration.googleapis.com
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.
Google Cloud oferece a gestão de identidade e de acesso (IAM), que lhe permite conceder acesso mais detalhado a recursos Google Cloud específicos 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 consola, dos métodos IAM da API ou da CLI do Google Cloud. Para mais informações, consulte o artigo Conceder, alterar e revogar o acesso a recursos.
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:
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.
Na linha de comandos, indique o caminho para o ficheiro, precedido pelo caráter
@, como o parâmetro--data:--data @<path-to-file>/<filename>
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:
Database Migration Service e Google APIs Discovery Service
O Google APIs Discovery Service é 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).