Com o conector Microsoft® SQL Server®, você pode usar comandos em uma cadeia para executar operações de linguagem de consulta estruturada (SQL) em bancos de dados do Microsoft SQL Server, incluindo soluções como o Microsoft Dynamics® Great Plains® (GP) ou o Yardi® Private Cloud. Por exemplo, com esse conector, você pode:
- Executar comandos SQL, incluindo uma instrução
CREATEouUPDATEou uma consultaSELECT - Recuperar detalhes sobre uma tabela no SQL Server
- Inserir registros em um banco de dados do SQL Server
Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.
Requisitos
Para habilitar a conexão com o banco de dados do SQL Server, o conector usa a conectividade de banco de dados Java (JDBC), protegida com autenticação básica de nome de usuário e senha. Para configurar o conector, você precisará de:
- Um usuário de integração designado criado no SQL Server para o conector
- O nome de usuário e a senha do usuário de integração
- O URL da conexão JDBC, como
jdbc:sqlserver://localhost:1433;[opções] - Para se conectar a um banco de dados do SQL Server local, um GroundRunner para a conexão
Versões suportadas
O conector do Microsoft® SQL Server® é compatível com as seguintes versões de banco de dados :
- Banco de dados SQL do Azure
- Análise de sinapse do Azure
- Instância Gerenciada de SQL do Azure
- SQL Server 2022
- SQL Server 2019
- SQL Server 2017
- SQL Server 2016
- SQL Server 2014
Configure o conector do Microsoft SQL Server
Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.
- Em Construtor de cadeia, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Conector Conexão, selecione Microsoft SQL Server e o executor a ser usado com a conexão.
- Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
- Em Propriedades, insira os detalhes do conector:
Propriedade Detalhes Nome de usuário Digite o nome de usuário do usuário de integração do SQL Server do conector. Senha Digite a senha da propriedade Nome de usuário. URL de conexão Digite o URL da conexão JDBC, como jdbc:sqlserver://<server>:<port>. Para incluir propriedades opcionais para a conexão, acrescente-as após um ponto e vírgula, comojdbc:sqlserver://localhost:1433;<options>. Por exemplo, para se conectar a um banco de dados usando a segurança integrada do Active Directory®:;databasename=<database>;integratedSecurity=True;authenticationScheme=NTLMObservação: Por padrão, a porta é
1433; no entanto, isso pode ser diferente para o seu ambiente.Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256. Para fins de segurança, evite incluir credenciais de usuário como propriedades opcionais na propriedade URL de conexão.
- Selecione os ambientes a serem usados com a conexão e clique em Salvar.
- Para testar a conexão, crie e execute uma cadeia com o comando Get Table Definition do conector e verifique se ele retorna uma saída válida.
Solução de problemas
Se a conexão com o SQL Server falhar:
- Verifique as credenciais de autenticação do usuário de integração.
- Verifique o URL da conexão JDBC, incluindo o servidor e a porta
- Se você estiver se conectando a um banco de dados local, verifique o GroundRunner selecionado para o conector.
Se a conexão não conseguir executar um comando, verifique se as entradas - como a sintaxe ou a tabela SQL - são válidas.