Programar uma transferência do Oracle

Console

1. Acesse a página "Transferências de dados" no console do Google Cloud.

   Acesse Transferências de dados

2. Clique em add Criar transferência.

3. Na seção Tipo de origem, em Origem, selecione Oracle.

4. Na seção Detalhes da fonte de dados, faça o seguinte:

   • Em Anexo de rede, selecione um anexo de rede existente ou clique em Criar anexo de rede.
   • Em Host, insira o nome do host ou o IP do banco de dados.
   • Em Porta, insira o número da porta que o banco de dados Oracle está usando para conexões de entrada, como 1520.
   • Em Nome do banco de dados, insira o nome do banco de dados Oracle.
   • Em Tipo de conexão, insira o tipo de URL de conexão: SERVICE, SID ou TNS.
   • Em Nome de usuário, digite o nome do usuário que iniciou a conexão com o banco de dados Oracle.
   • Em Senha, insira a senha do usuário que iniciou a conexão do banco de dados Oracle.

   • Em Objetos da Oracle para transferir, clique em PROCURAR para selecionar as tabelas a serem transferidas para o conjunto de dados de destino do BigQuery.

     • Nesse campo, também é possível inserir manualmente qualquer objeto para incluir na transferência de dados.

     

5. Na seção Configurações de destino, em Conjunto de dados, escolha o conjunto criado para armazenar seus dados.

6. No campo Nome de exibição, na seção Nome de configuração da transferência, insira um nome para a transferência de dados.

7. Na seção Opções de programação, faça o seguinte:

   • Na lista Frequência de repetição, selecione uma opção para especificar com que frequência essa transferência de dados é executada. Para especificar uma frequência de repetição personalizada, selecione Personalizada. Se você selecionar Sob demanda, essa transferência vai ser executada quando você acionar manualmente a transferência.

   • Se aplicável, selecione Começar agora ou Começar no horário definido e forneça uma data de início e um horário de execução.

8. No menu Conta de serviço, selecione uma conta de serviço associada ao seu projeto do Google Cloud. A conta de serviço selecionada precisa ter os papéis necessários para executar a transferência de dados.

   Se você fez login com uma identidade federada, é necessário uma conta de serviço para criar uma transferência de dados. Se você fez login com uma Conta do Google, uma conta de serviço para a transferência é opcional.

   Para mais informações sobre o uso de contas de serviço com transferências de dados, consulte Usar contas de serviço.

9. Opcional: na seção Opções de notificação, faça o seguinte:

   • Para ativar as notificações por e-mail, clique no botão de alternância Notificação por e-mail. Quando essa opção está ativada, o administrador de transferência recebe uma notificação por e-mail quando uma execução de transferência falha.
   • Para ativar as notificações de execução de transferência do Pub/Sub para essa transferência, clique no botão de alternância Notificações do Pub/Sub. Selecione o nome do tópico ou clique em Criar um tópico.

10. Clique em Salvar.

bq

Insira o comando bq mk e forneça a sinalização de execução da transferência --transfer_config:

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Em que:

• PROJECT_ID (opcional): o ID do projeto do Google Cloud. Se --project_id não for fornecido para especificar um projeto determinado, o projeto padrão será usado;
• DATA_SOURCE: a fonte de dados — oracle.
• DISPLAY_NAME: o nome de exibição da configuração da transferência. O nome da transferência de dados pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.
• DATASET: o conjunto de dados de destino na configuração da transferência.

• PARAMETERS é o parâmetro da configuração de transferência criada no formato JSON. Por exemplo, --params='{"param":"param_value"}'. Veja a seguir os parâmetros de uma transferência de dados do Oracle:

  • connector.networkAttachment (opcional): nome do anexo de rede para se conectar ao banco de dados Oracle.
  • connector.authentication.Username: nome de usuário da conta do Oracle.
  • connector.authentication.Password: senha da conta do Oracle.
  • connector.database: nome do banco de dados do Oracle.
  • connector.endpoint.host: o nome do host ou IP do banco de dados.
  • connector.endpoint.port: o número da porta que o banco de dados Oracle está usando para conexões de entrada, como 1520.
  • connector.connectionType: o tipo de URL de conexão, SERVICE, SID ou TNS.
  • assets: o caminho para os objetos do Oracle que serão transferidos para o BigQuery, usando o formato: DATABASE_NAME/SCHEMA_NAME/TABLE_NAME

Por exemplo, o comando a seguir cria uma transferência de dados do Oracle no projeto padrão com todos os parâmetros necessários:

bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=oracle \
    --display_name='My Transfer' \
    --params='{"assets":["DB1/USER1/DEPARTMENT","DB1/USER1/EMPLOYEES"], \
        "connector.authentication.username": "User1", \
        "connector.authentication.password":"ABC12345", \
        "connector.database":"DB1", \
        "Connector.endpoint.host":"192.168.0.1", \
        "Connector.endpoint.port":"1520", \
        "connector.connectionType":"SERVICE", \
        "connector.networkAttachment": \
        "projects/dev-project1/regions/us-central1/networkattachments/na1"}'

API

Use o método projects.locations.transferConfigs.create e forneça uma instância do recurso TransferConfig.