Domande frequenti per i clienti di DB SQL di Server
Questo articolo fornisce una panoramica del supporto per Alteryx Server con SQL gestito dall'utente come livello di persistenza e informazioni sulla migrazione da MongoDB a SQL.
DOMANDE FREQUENTI SU SQL
1. Quali versioni di SQL sono supportate?
Sono ufficialmente supportate le versioni 2019 e 2022 di MSSQL Server.
2. Le versioni cloud di SQL sono supportate?
Le uniche versioni ufficialmente supportate sono MSSQL Server 2019 e 2022. Alcune versioni cloud di SQL potrebbero funzionare ma non sono supportate da Alteryx.
3. Quale livello di autorizzazione è richiesto per l'installazione di SQL?
L'utente con accesso al database SQL deve inizialmente disporre dei privilegi di amministratore per creare e utilizzare qualsiasi database richiesto da Alteryx Server. Una volta completata l'installazione di SQL e ogni eventuale migrazione da MongoDB a SQL (se applicabile), è possibile limitare questi privilegi. L'utente, tuttavia, avrà ancora bisogno delle autorizzazioni di lettura, scrittura, eliminazione record e creazione o eliminazione tabelle, ma non saranno più necessari i diritti completi per la creazione di database.
4. Esiste un'opzione di database incorporato per SQL?
No, al momento offriamo MSSQL solo come opzione di database per database gestiti dall'utente.
5. Il DB SQL può utilizzare connessioni SSL/TLS?
Sì.
6. È supportata l'autenticazione Kerberos per SQL?
Sì.
7. È supportata l'autenticazione WinAuth per SQL?
Sì.
8. Lo schema tra Mongo e SQL è cambiato?
Sì. Con il nuovo DB SQL sono state apportate leggere modifiche allo schema. Se Mongo veniva interrogato direttamente, occorre controllare le query ed eventualmente aggiornarle. Per ulteriori informazioni, vai alla pagina SQL DB Schema Reference della guida.
9. I database di Alteryx Service e Alteryx Gallery devono essere due database separati?
No, questi database possono condividere la stessa posizione.
10. È possibile configurare un nuovo ambiente FIPS utilizzando SQL in 2024.1?
Sì.
11. È possibile aggiungere un DB SQL Alteryx personale a una distribuzione SQL esistente?
Sì, è possibile eseguire un'istanza di SQL Server insieme ad altre istanze del database.
12. Che differenza c'è tra le prestazioni di Mongo e quelle di SQL?
Nella maggior parte dei casi, le prestazioni di SQL e Mongo dovrebbero essere le stesse. Prestazioni significativamente più lente si verificano solamente per i flussi di lavoro la cui esecuzione richiede 5 secondi o meno. Consulta la tabella riportata di seguito per un confronto dei tempi. Per i flussi di lavoro la cui esecuzione richiede più di 5 secondi, le differenze di prestazioni sono trascurabili.
Nel caso più estremo, se un utente eseguisse 60 flussi di lavoro al minuto che richiedono 1 secondo ciascuno, la differenza nel tempo di completamento passerebbe da 1 minuto in Mongo a 1 minuto e 15 secondi in SQL.
In definitiva, la differenza di prestazioni dipende dai flussi di lavoro in esecuzione, ma poiché un rallentamento si verifica solo con flussi di lavoro ad esecuzione rapida, la differenza di 0,25 secondi non dovrebbe determinare un divario significativo nelle prestazioni.
Tempo di esecuzione dei flussi di lavoro in Mongo | Tempo di esecuzione dei flussi di lavoro in SQL |
---|---|
5 secondi | 5,25 secondi |
1 secondo | 1,25 secondi |
Domande frequenti sulla migrazione da MongoDB a MSSQL
Per le istruzioni complete sulla migrazione da MongoDB a SQL, consulta la MongoDB to SQL Migration Guide. Consigliamo di leggere le istruzioni complete sulla migrazione poiché questa domanda frequente risponde solo ai dubbi principali.
1. Quale versione di Server è possibile aggiornare alla versione 2024.1 per il supporto della migrazione completa (da Mongo a SQL)?
Server 2022.1+. Se utilizzi una versione precedente alla 2022.1, ti consigliamo di eseguire l'aggiornamento alla versione 2022.1 - 2023.2 prima di eseguire l'aggiornamento alla versione 2024.1.
2. Lo strumento di migrazione da MongoDB a MSSQL funziona per i database Mongo incorporati e i database Mongo (Enterprise o Atlas) gestiti dagli utenti?
Sì.
3. La migrazione SQL è inclusa nell'aggiornamento alla versione 2024.1?
No, la migrazione SQL viene eseguita tramite un flusso di lavoro che è possibile eseguire dopo l'aggiornamento alla versione 2024.1. Ciò consente di eseguire l'aggiornamento alla versione 2024.1 ed eseguire i test iniziali prima di eseguire la migrazione a SQL.
4. Dove è possibile scaricare il flusso di lavoro della migrazione a SQL?
5. È necessario eseguire la migrazione a SQL nella versione 2024.1?
No. La migrazione è facoltativa e se non desideri eseguirla nella versione 2024.1, potrai eseguire la migrazione a SQL in una versione futura.
6. Quali dimensioni del database sono consigliate per SQL in caso di migrazione?
Consigliamo di raddoppiare le dimensioni del DB SQL rispetto al DB Mongo esistente. Questo perché Mongo comprime le dimensioni del database mentre in MSSQL la compressione non viene eseguita.
7. Per eseguire la migrazione è necessario che il servizio sia disattivato?
Per i test, è possibile eseguire lo strumento di migrazione quando il servizio è in esecuzione. Una volta completati i test, elimina tutti i record (non le tabelle) dal database SQL prima di eseguire la migrazione effettiva. Arresta completamente il servizio per la migrazione effettiva e al termine tutti i record verranno spostati.
8. È possibile arrestare lo strumento di migrazione prima che abbia completato la migrazione? Cosa succede se la migrazione viene interrotta?
Sì. Se lo strumento di migrazione viene interrotto o arrestato prima di aver completato la migrazione, continuerà a trasferire i record riprendendo dal punto in cui era stato interrotto. Ciò accade solo se il servizio resta disattivato e il database non viene modificato durante il periodo di arresto.
Se si interrompe la migrazione e il DB Mongo viene modificato, quando il servizio viene avviato dovrà essere cancellato, il contenuto della tabella SQL ma non le tabelle stesse prima di eseguire nuovamente lo strumento di migrazione.
9. Come si fa a capire quando la migrazione è stata completata correttamente?
Nella finestra dei risultati vengono visualizzati 0 errori e i log mostrano tutti i record trasferiti da MongoDB a MSSQL.
10. Quali errori si verificano più di frequente durante l'esecuzione della migrazione?
bcp_batch
Esempio di messaggio di errore:
MongoToSQL_Migration_Macro (829): Migrator (22): Record #17: BatchTransferProcess (574): Record #1: Tool #9: Unable to find address for bcp_batch”
Quando si verifica questo errore? Durante la migrazione; l'errore viene visualizzato nella finestra dei risultati.
Soluzione: assicurati che sia installato e configurato il driver SQL corretto (driver ODBC 17 per SQL).
Avvio del servizio non riuscito dopo la migrazione
Esempio di messaggio di errore (nei log di servizio):
ERROR,1,AlteryxServerMigrator,migrationLogger,ExecuteServerSqlDbMigrations,Server SQL database migrations have failed: Exception has been thrown by the target of an invocation.
Quando si verifica questo errore?
Dopo la migrazione; l'errore viene visualizzato in \Alteryx\Service\alteryx-migration.csv.
Questo errore può verificarsi se non specifichi correttamente un driver come parte della stringa di connessione dell'interfaccia utente di Server.
Soluzione:
PRIMA della migrazione dei dati a MSSQL, AlteryxService deve essere avviato almeno una volta con MongoDB come backend. In questo modo lo schema MongoDB viene aggiornato correttamente.
Rivedi le stringhe di connessione. In particolare, assicurati di non specificare un driver nella stringa di connessione della persistenza dell'interfaccia utente di Server. Per ulteriori informazioni, accedi a stringhe di connessione avanzate di DB SQL.
Errore di conversione da stringa a numero
Esempio di messaggio di errore:
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 si verifica questo errore? Durante la migrazione; l'errore viene visualizzato nella finestra dei risultati.
Soluzione: AlteryxService deve essere avviato almeno una volta con MongoDB come back-end PRIMA di migrare i dati a MSSQL. In questo modo lo schema MongoDB viene aggiornato correttamente.
AlteryxGallery.alteryx_server.Table_Name
Esempio di messaggio di errore:
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 si verifica questo errore? Durante la migrazione; l'errore viene visualizzato nella finestra dei risultati.
Soluzione:
Assicurati che lo schema MongoDB sia PUBBLICATO in MongoDB durante la configurazione del driver Simba.
Assicurati di definire l'origine dell'autenticazione appropriata durante la creazione delle credenziali DCM per ogni connessione. Per accedere alla casella di testo Origine dell'autenticazione, durante la creazione delle credenziali espandi la sezione Parametri avanzati sotto le voci Nome utente e Password.
Se utilizzi la versione integrata di MongoDB, sono necessarie due credenziali separate per l'origine dell'autenticazione: una mediante il database AlteryxService e l'altra mediante il database AlteryxGallery. Per ulteriori informazioni, consulta la Guida alla migrazione da Mongo a SQL.
Comando non autorizzato durante l'installazione dello schema MongoDB
Esempio di messaggio di errore:
[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 si verifica questo errore? Durante il tentativo di pubblicare lo schema MongoDB durante l'installazione del driver Simba.
Soluzione: assicurati che il database di autenticazione sia impostato sul database di destinazione. Quindi, quando viene creata la voce DSN per AlteryxGallery, imposta il database di autenticazione su AlteryxGallery invece che su admin.
11. Cosa si deve fare se la migrazione non riesce e come si viene avvisati?
Se la migrazione non riesce, il flusso di lavoro genera degli errori. In tal caso, segnala l'errore riportato nella finestra Risultati e invia al team di supporto eventuali screenshot e i file di log creati durante l'esecuzione.
Se la migrazione non riesce, puoi avviare nuovamente AlteryxService e continuare a utilizzare MongoDB. A questo punto, Mongo è ancora connesso e funzionante, quindi non è necessario fare altro per continuare a utilizzare Mongo se la migrazione non viene portata a termine.
12. Cosa succede se dopo la migrazione si vuole tornare a utilizzare MongoDB?
Se è stato eseguito un backup del file RuntimeSettings.xml prima della migrazione, puoi sostituirlo con il file RuntimeSettings.xml corrente (può essere utile eseguire il backup di questi due file). Tuttavia, le modifiche apportate a Server durante la connessione a SQL non compariranno dopo essere tornati a MongoDB.
13. La migrazione a SQL modifica il vecchio MongoDB?
No. I dati restano invariati. Tuttavia, viene creata una raccolta per salvare lo schema per il driver ODBC Simba per MongoDB.
14. È possibile migrare a SQL una versione FIPS di Server?
La migrazione da MongoDB a SQL non è attualmente supportata per gli ambienti FIPS. Tuttavia, è possibile configurare NUOVI ambienti FIPS utilizzando MSSQL gestito dall'utente.