Google BigQuery

Você pode usar o Google BigQuery como uma plataforma de dados de destino em um pipeline de dados. Em um pipeline de dados, várias operações podem ser realizadas na plataforma de destino, incluindo aterrissagem de dados, armazenamento de dados, transformação de dados, criação de datamart e registro de dados.

Isso envolve:

• Atender aos pré-requisitos
• Configurando uma conexão com o Google BigQuery

Configurando uma conexão com o Google BigQuery

Selecione o conector do Google BigQuery Target e defina as configurações a seguir.

Destino de dados

Gateway de dados: O Data Movement gateway apenas será necessário se o banco de dados de destino não estiver acessível a partir do Qlik Cloud e somente pode ser acessado através de um link privado (por exemplo, se estiver localizado em uma nuvem privada virtual). Se esse for o caso, selecione o Data Movement gateway através do qual você deseja acessar o banco de dados de destino.

Dependendo do seu caso de uso, será o mesmo Data Movement gateway implantado para obter dados da fonte de dados ou de uma fonte diferente. Para obter informações sobre as possibilidades de implantação do Data Movement gateway, consulte Casos de uso comuns.

Se o banco de dados de destino estiver acessível diretamente no Qlik Cloud, selecione Nenhum.

Propriedades da conexão

Chave da conta de serviço: baixe o arquivo JSON que foi baixado quando você criou a chave da conta de serviço do BigQuery.

Localização: onde carregar o conjunto de dados criado pela Qlik. Se você selecionar Outro, insira o nome da região no campo Nome da região. Para ver uma lista de nomes de regiões compatíveis, consulte Locais do BigQuery.

Nome

O nome de exibição da conexão.

Pré-requisitos

Permissões necessárias para aterrisar dados

Permissões necessárias para criar o conjunto de dados de destino automaticamente:

Se você deseja que o conjunto de dados seja criado automaticamente, as seguintes permissões são necessárias:

BigQuery > Usuário de trabalho do BigQuery

BigQuery > Editor de dados do BigQuery

Permissões necessárias quando o conjunto de dados de destino já existe:

Se o conjunto de dados já existir, você precisará executar as seguintes etapas:

1. Crie uma conta de serviço com a seguinte permissão:

   BigQuery > Usuário de trabalho do BigQuery

2. Navegue até o conjunto de dados que você deseja usar e, em seguida:

   1. Adicione a conta de serviço que você acabou de criar como principal.

   2. Atribua a função Editor de Dados do BigQuery.

Configuração do driver

Um driver apenas será necessário se você estiver acessando o banco de dados via Data Movement gateway. Nesse caso, você precisa instalar o driver na máquina Data Movement gateway.

Você pode instalar o driver usando o utilitário de instalação do driver (recomendado) ou manualmente. A instalação manual só deve ser tentada no caso improvável de você encontrar um problema com o utilitário de instalação do driver.

Usando o utilitário de instalação de driver para instalar o driver

Esta seção descreve como instalar o driver necessário. O processo envolve a execução de um script que baixará, instalará e configurará automaticamente os driver necessários. Você também pode executar scripts para atualizar e desinstalar o driver como necessário.

Preparando a instalação

• Certifique-se de que o Python 3.6.x ou mais recente esteja instalado no servidor de gateway do Movimentação de dados.

  O Python vem pré-instalado na maioria das distribuições do Linux. Você pode verificar qual versão do Python está instalada em seu sistema executando o seguinte comando:

  python3 --version

Instalando o driver

Para baixar e instalar o driver:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since <timestamp> ago

3. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

4. Execute o seguinte comando:

   Sintaxe:

   ./install gbq

   Se o driver não puder ser baixado (devido a restrições de acesso ou problemas técnicos), uma mensagem será exibida informando onde baixar o driver e onde copiá-lo na máquina de gateway do Movimentação de dados. Depois de fazer isso, execute o comando install gbq novamente.

   Caso contrário, o EULA do driver será exibido.

5. Realize uma das seguintes ações:

   • Pressione [Enter] repetidamente para percorrer lentamente o EULA.
   • Pressione a barra de espaço repetidamente para rolar rapidamente pelo EULA.
   • Pressione q para sair do texto da licença e ser apresentado às opções de aceitação do EULA.

6. Realize uma das seguintes ações:

   • Digite "y" e pressione [Enter] para aceitar o EULA e iniciar a instalação.
   • Digite "n" e pressione [Enter] para rejeitar o EULA e sair da instalação.

   • Digite "v" e pressione [Enter] para visualizar o EULA novamente.

O driver será instalado.

7. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

8. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since <timestamp> ago

Atualizando o driver

Execute o comando de atualização se quiser desinstalar versões anteriores do driver antes de instalar o driver fornecido.

Para baixar e atualizar o driver:

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: inactive (dead) since <timestamp> ago

3. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

4. Execute o seguinte comando:

   Sintaxe:

   ./update gbq

   Se o driver não puder ser baixado (devido a restrições de acesso ou problemas técnicos), uma mensagem será exibida informando onde baixar o driver e onde copiá-lo na máquina de gateway do Movimentação de dados. Depois de fazer isso, execute o comando update gbq novamente.

   Caso contrário, o EULA do driver será exibido.

5. Realize uma das seguintes ações:

   • Pressione [Enter] repetidamente para percorrer lentamente o EULA.
   • Pressione a barra de espaço repetidamente para rolar rapidamente pelo EULA.
   • Pressione q para sair do texto da licença e ser apresentado às opções de aceitação do EULA.

6. Realize uma das seguintes ações:

   • Digite "y" e pressione [Enter] para aceitar o EULA e iniciar a instalação.
   • Digite "n" e pressione [Enter] para rejeitar o EULA e sair da instalação.
   • Digite "v" e pressione [Enter] para revisar o EULA desde o início.

O driver antigo será desinstalado, e o novo driver será instalado.

7. Aguarde a conclusão da instalação (indicada por "Concluído!") e inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

8. Opcionalmente, confirme se o serviço foi iniciado:

   sudo systemctl status repagent

   O status deverá ser o seguinte:

   Active: active (running) since <timestamp> ago

Desinstalando o driver

Execute o comando de desinstalação se quiser desinstalar o driver.

Para desinstalar o driver:

1. Pare todas as tarefas configuradas para usar esse conector.

2. Na máquina do gateway do Movimentação de dados, altere o diretório de trabalho para:

   opt/qlik/gateway/movement/drivers/bin

3. Execute o seguinte comando:

   Sintaxe:

   ./uninstall gbq

   O driver será desinstalado.

Instalando o driver manualmente

Você só deve tentar instalar o driver manualmente se a instalação automática do driver não for concluída com êxito.

Você precisa instalar um driver ODBC e um driver JDBC.

Instalar o driver ODBC

Após a instalação do Data Movement gateway, baixe os arquivos SimbaODBCDriverforGoogleBigQuery_<version>-Linux.tar.gz e google-cloud-sdk-<version>-linux-x86_64.tar.gz. Você pode encontrar links diretos para download desses arquivos em binary-artifacts em /opt/qlik/gateway/movement/drivers/manifests/gbq.yaml. Assim que o download for concluído, copie os arquivos para a máquina Data Movement gateway.

1. Pare o serviço do Gateway Data Movement:

   sudo systemctl stop repagent

2. Opcionalmente, confirme se o serviço foi interrompido:

   sudo systemctl status repagent

O status deverá ser o seguinte:

Active: inactive (dead) since <timestamp> ago

3. Extração:

   SimbaODBCDriverforGoogleBigQuery_<version>.tar.gz

   para:

   /opt/SimbaODBCDriverforGoogleBigQuery_<version>-Linux

4. Mova os arquivos GoogleBigQueryODBC.did e simba.googlebigqueryodbc.ini para o diretório lib no diretório do Simba ODBC Driver.

   Exemplo:

   Mova os arquivos de:

   /opt/SimbaODBCDriverforGoogleBigQuery_<version>-Linux/setup

   para:

   /opt/SimbaODBCDriverforGoogleBigQuery_<version>-Linux/SimbaODBCDriverforGoogleBigQuery64_<version>/lib

5. Edite o arquivo simba.googlebigqueryodbc.ini da seguinte forma:

   1. Altere ErrorMessagesPath para o caminho do arquivo XML que contém as mensagens ODBC. A localização padrão é:

      ErrorMessagesPath=/opt/SimbaODBCDriverforGoogleBigQuery_<version>-Linux/SimbaODBCDriverforGoogleBigQuery64_<version>/ErrorMessages

   2. Altere DriverManagerEncoding para UTF-16.

6. Adicione o seguinte caminho ao arquivo site_arep_login.sh, localizado no diretório bin do Gateway Data Movement:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/SimbaODBCDriverforGoogleBigQuery_<version>-Linux/SimbaODBCDriverforGoogleBigQuery64_<version>/lib

7. Edite o arquivo /etc/odbcinst.ini e adicione o caminho do driver (ou seja, o caminho onde o driver está instalado):

   [ODBC Drivers]

   Simba= Installed

   Simba ODBC Driver for Google BigQuery = Installed

   [Simba ODBC Driver for Google BigQuery]

   Description=Simba ODBC Driver for Google BigQuery(64-bit)

   Driver=/opt/SimbaODBCDriverforGoogleBigQuery_<version>-Linux/SimbaODBCDriverforGoogleBigQuery64_<version>/lib/libgooglebigqueryodbc_sb64.so

8. Instale google-cloud-sdk-<version>-linux-x86_64.tar.gz.

9. Inicie o serviço do Gateway Data Movement:

   sudo systemctl start repagent

10. Opcionalmente, confirme se o serviço foi iniciado:

    sudo systemctl status repagent

    O status deverá ser o seguinte:

    Active: active (running) since <timestamp> ago

Instalando o driver JDBC e suas dependências

1. Baixe o seguinte arquivo ZIP e arquivos JAR listados em binary-artifacts em /opt/qlik/gateway/movement/drivers/manifests/gbq.yaml:

   • https://repo1.maven.org/maven2/com/google/cloud/google-cloud-bigquery/<version>/google-cloud-bigquery-<version>.jar
   • https://repo1.maven.org/maven2/com/google/cloud/google-cloud-storage/<version>/google-cloud-storage-<version>.jar
   • https://storage.googleapis.com/simba-bq-release/jdbc/SimbaJDBCDriverforGoogleBigQuery<version>.zip

   Copie os arquivos JAR para a seguinte pasta na máquina do Data Movement gateway e extraia os arquivos JAR em SimbaJDBCDriverforGoogleBigQuery<version>.zip para a mesma pasta:

   /opt/qlik/gateway/movement/qcs_agents/qdi-db-commands/lib

2. Reinicie o serviço Data Movement gateway executando o comando descrito em Reiniciando o serviço

Porta

A porta 443 do firewall precisa ser aberta para comunicação de saída.

Tipos de dados

O comprimento do tipo de dados parametrizado será definido com valores padrão:

• STRING: 8192 (comprimento)

• BYTES: 8192 (comprimento)

• NUMERIC: precisão: 38, escala: 9

• BIGDECIMAL: precisão: 76, escala: 38

A tabela a seguir mostra os tipos de dados Google BigQuery que são suportados durante o uso do Qlik Cloud e o mapeamento padrão dos tipos de dados do Qlik Cloud.

As informações do tipo de dados nativo são preservadas e exibidas na coluna Tipo de dados nativo nas visualizações do conjunto de dados. Se a coluna não estiver visível, será necessário abrir o seletor de colunas da visualização do conjunto de dados e selecionar a coluna Tipo de dados nativo.

Os seguintes tipos de dados são convertidos em STRING:

• ARRAY

• STRUCT

• JSON

• GEOGRAPHY

Você só deve tentar instalar o driver manualmente se a instalação automática do driver não for concluída com êxito.