# Pré-requisitos [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/SQLServer/sqlserver-prerequisites.htm) Antes de fazer a aterrissagem ou a replicação dos dados, certifique-se de atender aos seguintes pré-requisitos: * Instalar o driver necessário no servidor do Gateway do Data Movement Nota informativa Isso apenas será necessário se você optar por trabalhar com o Gateway do Data Movement. Para obter informações sobre os benefícios do Gateway do Data Movement e quando ele é necessário, consulte [Qlik Data Gateway - Data Movement](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm). * Conceder as permissões necessárias na fonte de dados * Configurar o conector de fontes de dados ## Configuração do driver 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 Data Movement. 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. Na máquina do gateway do Data Movement, altere o diretório de trabalho para: opt/qlik/gateway/movement/drivers/bin 2. Execute o seguinte comando: Sintaxe: ./install sqlserver 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 Data Movement. Depois de fazer isso, execute o comando install sqlserver novamente. Caso contrário, o EULA do driver será exibido. 3. 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. 4. 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. ### 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. Na máquina do gateway do Data Movement, altere o diretório de trabalho para: opt/qlik/gateway/movement/drivers/bin 2. Execute o seguinte comando: Sintaxe: ./update sqlserver 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 Data Movement. Depois de fazer isso, execute o comando update sqlserver novamente. Caso contrário, o EULA do driver será exibido. 3. 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. 4. 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. ### 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 Data Movement, altere o diretório de trabalho para: opt/qlik/gateway/movement/drivers/bin 3. Execute o seguinte comando: Sintaxe: ./uninstall sqlserver 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. Após a instalação do Gateway do Data Movement, baixe o driver msodbcsql<versão>.x86\_64.rpm. Você pode encontrar um link de download direto para a versão compatível em binary-artifacts em /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml. Assim que o download for concluído, copie o RPM para a máquina Gateway do Data Movement. No servidor do Data Movement gateway, abra um prompt de shell e faça o seguinte: 1. Pare o serviço do Data Movement gateway: 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. Instale o driver (RPM). 4. Altere o diretório de trabalho para <product\_dir>/bin. 5. Copie a localização do driver para o arquivo `site_arep_login.sh`, conforme a seguir: ``` echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql/lib64/" >> site_arep_login.sh ``` Isso adicionará o driver a "LD\_LIBRARY\_PATH" e atualizará a localização do driver no arquivo **site\_arep\_login.sh** . 6. Opcionalmente, confirme se a localização do driver foi copiada: ``` cat site_arep_login.sh ``` 7. Inicie o serviço do Data Movement gateway: 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 9. O Data Movement gateway requer a seguinte biblioteca ODBC: msodbcsql-18.1.so.1.1 Para verificar qual versão da biblioteca está instalada no momento, emita o seguinte comando: ``` ls /opt/microsoft/msodbcsql/lib64/ ``` Se a biblioteca existente tiver um número de versão diferente (por exemplo libmsodbcsql-18.0.so.1.1), você precisará criar um link simbólico entre a biblioteca existente e a biblioteca necessária. Para fazer isso, emita os seguintes comandos: ``` cd /opt/microsoft/msodbcsql/lib64/ ``` ``` ln -s existing_library_name msodbcsql-18.1.so.1.1 ``` em que `existing_library_name` é o nome da biblioteca atualmente instalada (por exemplo. libmsodbcsql-18.0.so.1.1). Nota de advertênciaSe você estiver usando um destino do Microsoft Fabric, a desinstalação do driver Microsoft ODBC Driver for SQL Server também interromperá a conectividade com o Microsoft Fabric, pois ambos usam o mesmo driver. ## Porta Por padrão, a porta 1434 precisa ser aberta para comunicação de saída no servidor do Gateway Data Movement. Você pode alterar isso nas configurações do conector. ## Pré-requisitos gerais * O banco de dados do Microsoft SQL Server deve estar habilitado para MS-REPLICATION. Para obter mais informações, consulte [Configurando o Microsoft SQL Server para replicação](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/SQLServer-Source/sqlserver_replication.htm). * É necessária uma conta do Microsoft SQL Server com os privilégios de acesso específicos. Para obter mais informações, consulte [Permissões necessárias](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/SQLServer-Source/SQLServerDBSource_Security.htm). * O Microsoft SQL Server como origem deve ser configurado para que um backup completo funcione com o Qlik Data Gateway - Data Movement. Para obter mais informações, consulte [Preparar o backup e a recuperação do Microsoft SQL Server](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Global_Common/Content/SharedReplicateHDD/SQLServer-Source/sqlserver_backup.htm). ## Seleção do banco de dados Para poder selecionar um banco de dados (clicando em Carregar bancos de dados no diálogo do conector), o usuário especificado nas configurações do conector precisa ser criado no banco de dados mestre.