Perguntas frequentes dos clientes sobre o SQL DB do Server
Este artigo fornece uma visão geral do nosso suporte para o Alteryx Server com SQL gerenciado pelo usuário como camada de persistência e informações sobre a migração do MongoDB para o SQL.
Perguntas frequentes sobre o SQL
1. Quais versões do SQL são compatíveis?
Oferecemos suporte oficial ao MSSQL Server 2019 e 2022.
2. As versões do SQL na nuvem são compatíveis?
As únicas versões com suporte oficial são MSSQL Server 2019 e 2022. Algumas versões do SQL na nuvem podem funcionar, mas não são compatíveis com o Alteryx.
3. Qual o nível de permissão necessário para a configuração do SQL?
O usuário de acesso ao banco de dados SQL deve inicialmente ter privilégios de administrador para criar e usar qualquer banco de dados que o Alteryx Server exige. Quando a configuração do SQL estiver concluída e qualquer migração do MongoDB para SQL (se aplicável) tiver sido realizada, esses privilégios podem ser reduzidos. No entanto, o usuário ainda precisará de permissões para ler, gravar, excluir registros e criar ou excluir tabelas, mas os direitos de criação completos do banco de dados não serão mais necessários.
4. Existe alguma opção para o SQL como opção de banco de dados incorporado?
Não, neste momento, oferecemos apenas o MSSQL como opção de banco de dados para bancos de dados gerenciados pelo usuário.
5. Há suporte do SQL DB para conexões SSL/TLS?
Sim.
6. Há suporte para a autenticação Kerberos para SQL?
Sim.
7. Há suporte para a autenticação WinAuth para SQL?
Sim.
8. O esquema mudou entre o Mongo e o SQL?
Sim. Fizemos pequenas alterações de esquema no novo SQL DB. Se você estava consultando diretamente no Mongo, deve verificar suas consultas e possivelmente atualizá-las. Para obter mais informações, acesse a página de ajuda Referência de esquema do SQL DB.
9. Os DBs do Alteryx Service e do Alteryx Gallery precisam ficar separados?
Não, esses DBs podem estar localizados no mesmo lugar.
10. Um novo ambiente FIPS pode ser configurado usando o SQL na versão 2024.1?
Sim.
11. Posso adicionar o meu SQL DB do Alteryx a uma implantação SQL existente?
Sim, você pode executar uma instância de servidor do SQL ao lado de outras instâncias de bancos de dados.
12. Como se comparam os desempenhos do Mongo e do SQL?
O desempenho deve ser igual no SQL e no Mongo na maioria dos casos. O único desempenho significativamente mais lento ocorre para fluxos de trabalho que demoram 5 segundos ou menos para serem executados. Consulte a tabela abaixo para obter os tempos de comparação. Para fluxos de trabalho que demoram mais de 5 segundos para serem executados, as diferenças de desempenho são insignificantes.
No exemplo mais extremo, se um usuário executasse 60 fluxos de trabalho por minuto que levasse 1 segundo cada, a diferença no tempo de conclusão passaria de 1 minuto no Mongo para 1 minuto e 15 segundos no SQL.
Em última análise, a diferença de desempenho depende dos fluxos de trabalho em execução, mas como a desaceleração ocorre apenas com fluxos de trabalho de execução rápida, a diferença de 0,25 segundo não deve levar a uma diferença significativa no desempenho.
Tempo de execução de fluxos de trabalho do Mongo | Tempo de execução de fluxos de trabalho do SQL |
---|---|
5 segundos | 5,25 segundos |
1 segundo | 1,25 segundo |
Perguntas frequentes sobre o migrador do MongoDB para o MSSQL
Para verificar as instruções completas de migração do MongoDB para o SQL, acesse Guia de migração do MongoDB para o SQL. Revise as instruções completas de migração, pois estas perguntas frequentes respondem apenas às principais dúvidas.
1. Qual versão do Server eu posso atualizar para a 2024.1 para obter suporte total à migração (Mongo para SQL)?
Server 2022.1 e versões posteriores. Se você estiver em uma versão mais antiga do que a 2022.1, recomendamos que atualize para uma versão entre 2022.1 e 2023.2 antes de atualizar para a 2024.1.
2. O migrador do MongoDB para o MSSQL funciona para bancos de dados Mongo integrados e bancos de dados Mongo (Enterprise ou Atlas) gerenciados pelo usuário?
Sim.
3. A migração para o SQL faz parte da atualização 2024.1?
Não, a migração para o SQL é feita através de um fluxo de trabalho que você pode executar depois de atualizar para a versão 2024.1. Isso permite que você atualize para a versão 2024.1 e faça seus testes iniciais antes de migrar para o SQL.
4. Onde posso baixar o fluxo de trabalho da migração para o SQL?
5. Tenho que migrar para o SQL na versão 2024.1?
Não, faz todo o sentido. Esta é uma migração opcional e se você não quiser migrar para o SQL na versão 2024.1, pode migrar em uma versão futura.
6. Que tamanho de banco de dados vocês recomendam que o SQL tenha ao migrar?
Recomendamos que o tamanho do banco de dados do SQL seja o dobro do tamanho do MongoDB existente. Isso porque o Mongo comprime o tamanho do banco de dados e a mesma compactação não ocorre no MSSQL.
7. O serviço precisa estar desligado para que a migração seja executada?
Para o teste, você pode executar o migrador enquanto o serviço estiver em execução. Após o teste, exclua todos os registros (não tabelas) do SQL DB antes de executar a migração final. Desligue totalmente o serviço para a migração final e todos os registros serão movidos nesta etapa.
8. O migrador pode ser parado antes da conclusão? O que acontece se a migração for interrompida?
Sim. Se o migrador for interrompido ou parado antes da conclusão, ele começará de onde terminou e continuará transferindo registros. Isso só se aplica se o serviço permanecer desligado e não houver alterações no banco de dados durante o período da interrupção.
Se você parar a migração e o serviço for iniciado e as alterações forem feitas no MongoDB, então precisará limpar o conteúdo da tabela SQL, não as próprias tabelas, antes de executar novamente o migrador.
9. Como saberei que a migração foi concluída com sucesso?
Você verá 0 erros na janela de resultados e os logs mostrarão todos os registros transferidos do MongoDB para o MSSQL.
10. Quais são os erros comuns que eu posso obter ao executar a migração?
bcp_batch
Exemplo de mensagem de erro:
MongoToSQL_Migration_Macro (829): Migrator (22): Record #17: BatchTransferProcess (574): Record #1: Tool #9: Unable to find address for bcp_batch”
Quando ocorre o erro? Durante a migração, o erro será exibido na janela "Resultados".
Solução: verifique se o driver SQL correto está instalado e configurado (driver ODBC SQL 17).
Falha ao iniciar o serviço após a migração
Exemplo de mensagem de erro (em logs de serviço):
ERROR,1,AlteryxServerMigrator,migrationLogger,ExecuteServerSqlDbMigrations,Server SQL database migrations have failed: Exception has been thrown by the target of an invocation.
Quando ocorre o erro?
Após a migração, o erro será exibido em \Alteryx\Service\alteryx-migration.csv.
Você pode receber esse erro se especificar incorretamente um driver como parte da cadeia de conexão da IU do Server.
Solução:
O AlteryxService precisa iniciar pelo menos uma vez com o MongoDB como back-end ANTES de migrar dados para o MSSQL. Isso garante que o esquema do MongoDB seja atualizado corretamente.
Revise suas cadeias de conexão. Em particular, certifique-se de não especificar um driver na cadeia de conexão de persistência da IU do Server. Para obter mais informações, acesse Cadeias de conexão avançadas do SQL DB.
Falha na conversão de cadeia de caracteres para número
Exemplo de mensagem de
Error: MongoToSQL_Migration_Macro (829): Migrator (22): Record #54: BatchTransferProcess (574): Record #1: Tool #2: Error SQLFetch: [Simba][Support] (50090) Conversion from string to number failed with value ''[Simba][Support] (50090) Conversion from string to number failed with value ''[Simba][Support] (50090) Conversion from string to number failed with value ''
Quando ocorre o erro? Durante a migração, o erro será exibido na janela "Resultados".
Solução: o AlteryxService precisa iniciar pelo menos uma vez com o MongoDB como back-end ANTES de migrar dados para o MSSQL. Isso garante que o esquema do MongoDB seja atualizado corretamente.
AlteryxGallery.alteryx_server.Table_Name
Exemplo de mensagem de
Error: MongoToSQL_Migration_Macro (829): Tool #46: Error opening "SELECT COUNT(DISTINCT Primary_Key) AS Count_distinct FROM AlteryxGallery.alteryx_server.Table_Name": No Columns Returned.
Quando ocorre o erro? Durante a migração, o erro será exibido na janela "Resultados".
Solução:
Certifique-se de que o esquema do MongoDB seja PUBLICADO no MongoDB durante a configuração do driver Simba.
Certifique-se de definir a fonte da autenticação apropriada ao criar a credencial do DCM para cada conexão. Para acessar a caixa de texto "Fonte da autenticação", expanda a seção "Parâmetros avançados" abaixo das entradas de nome de usuário e senha ao criar suas credenciais.
Se você usar o MongoDB integrado, isso exigirá duas credenciais separadas: uma usando o banco de dados do AlteryxService e outra usando o banco de dados do AlteryxGallery para "Fonte da autenticação". Para obter mais informações, acesse Guia de migração do Mongo para o SQL.
Comando não autorizado durante a configuração do esquema do MongoDB
Exemplo de mensagem de erro
[Simba][MongoDBODBC] (110) Error from MongoDB Client: not authorized on test to execute command { insert: "DatabaseMetadata_SchemaMap", ordered: true, $db: "test", lsid: { id: UUID("9819f76d-486b-4722-a4f1-f8398cd9a4ae") } } (Error Code: 13)
Quando ocorre o erro? Ao tentar publicar o esquema do MongoDB durante a configuração do driver Simba.
Solução: certifique-se de que o banco de dados de autenticação está definido como o banco de dados de destino. Ao criar a entrada DSN para o AlteryxGallery, defina o banco de dados de autenticação como "AlteryxGallery", não "admin".
11. O que devo fazer se a migração falhar e como serei notificado?
O fluxo de trabalho produz erros durante a falha. Se isso ocorrer, relate o erro da janela Resultados e envie capturas de tela e arquivos de log criados durante a execução para nossa equipe de suporte.
Se a migração falhar, você pode iniciar o AlteryxService novamente e continuar usando o MongoDB. Neste ponto, o Mongo ainda está totalmente conectado e funcional, então você não precisa fazer nada adicional para continuar usando o Mongo se a migração falhar.
12. O que acontece se eu quiser voltar a usar o MongoDB após a migração?
Se você fez um backup do seu arquivo RuntimeSettings.xml antes da migração, poderá desligá-lo com seu arquivo RuntimeSettings.xml atual (fazer backups desses dois arquivos pode ajudar). No entanto, quaisquer alterações feitas no Server enquanto estiver conectado ao SQL não serão representadas após a troca de volta para o MongoDB.
13. A migração para o SQL fará alterações no MongoDB antigo?
Não, faz todo o sentido. Os dados ficam inalterados. No entanto, a coleção 1 é criada para armazenar o esquema para o ODBC do MongoDB do Simba.
14. Posso migrar uma versão FIPS do Server para o SQL?
Atualmente, a migração do MongoDB para o SQL não tem suporte para os ambientes FIPS. No entanto, novos ambientes FIPS podem ser configurados usando o MSSQL gerenciado pelo usuário.