Häufig gestellte Fragen von Kunden zur Server-SQL-DB
Dieser Artikel bietet einen Überblick über unsere Unterstützung für Alteryx Server mit benutzerverwalteter SQL als Persistenzschicht sowie Informationen zur Migration von MongoDB zu SQL.
Häufig gestellte Fragen zu SQL
1. Welche SQL-Versionen werden unterstützt?
Wir unterstützen offiziell MSSQL Server 2019 und 2022.
2. Werden Cloud-SQL-Versionen unterstützt?
Derzeit sind MSSQL Server 2019 und 2022 die einzigen offiziell unterstützten Versionen. Einige Cloud-SQL-Versionen funktionieren möglicherweise, werden aber nicht von Alteryx unterstützt.
3. Welche Berechtigungsebene ist für die SQL-Einrichtung erforderlich?
Der Benutzer für den SQL Database-Zugriff muss zunächst über Administratorberechtigungen verfügen, um Datenbanken zu erstellen und zu verwenden, die Alteryx Server erfordert. Sobald das SQL-Setup abgeschlossen ist und eine Migration von MongoDB zu SQL (falls zutreffend) durchgeführt wurde, können diese Berechtigungen reduziert werden. Der Benutzer benötigt jedoch weiterhin Berechtigungen zum Lesen, Schreiben, Löschen von Datensätzen und Erstellen oder Löschen von Tabellen, aber es sind keine vollständigen Rechte mehr für das Erstellen der Datenbank erforderlich.
4. Gibt es für SQL eine eingebettete Datenbankoption?
Nein, derzeit bieten wir nur MSSQL als Datenbankoption für benutzerverwaltete Datenbanken an.
5. Unterstützt die SQL-DB SSL-/TLS-Verbindungen?
Ja.
6. Wird die Kerberos-SQL-Authentifizierung unterstützt?
Ja.
7. Wird die WinAuth-SQL-Authentifizierung unterstützt?
Ja.
8. Hat sich das Schema zwischen Mongo und SQL geändert?
Ja. Bei der neuen SQL-DB sind leichte Schemaänderungen aufgetreten. Wenn Sie Abfragen direkt an Mongo gestellt haben, müssen Sie Ihre Abfragen überprüfen und möglicherweise aktualisieren. Weitere Informationen finden Sie auf der Hilfeseite zur Schema-Referenz für SQL-DB.
9. Müssen die Alteryx Service-DBs und Alteryx Gallery-DBs separate DBs sein?
Nein, diese DBs können sich am selben Ort befinden.
10. Kann eine neue FIPS-Umgebung mit SQL in 2024.1 eingerichtet werden?
Ja.
11. Kann ich meine Alteryx-SQL-DB zu einer vorhandenen SQL-Bereitstellung hinzufügen?
Ja, Sie können eine SQL-Server-Instanz neben anderen Datenbankinstanzen ausführen.
12. Wie sieht die Leistung im Vergleich zwischen Mongo und SQL aus?
In den meisten Fällen sollte die Leistung von SQL und Mongo gleich sein. Nur bei Workflows, deren Ausführung 5 Sekunden oder weniger dauert, ist die Leistung deutlich geringer. Die Vergleichszeiten finden Sie in der Tabelle unten. Bei Workflows, deren Ausführung länger als 5 Sekunden dauert, sind die Leistungsunterschiede vernachlässigbar.
Ein Extrembeispiel: Bei der Ausführung von 60 Workflows pro Minute, die jeweils 1 Sekunde dauerten, stieg die Abschlusszeit von 1 Minute in Mongo auf 1 Minute 15 Sekunden in SQL.
Letztendlich hängt der Leistungsunterschied davon ab, welche Workflows ausgeführt werden. Da die Verlangsamung jedoch nur bei schnell ausgeführten Workflows auftritt, sollte der Unterschied von 0,25 Sekunden nicht zu einem signifikanten Leistungsunterschied führen.
Mongo-Workflow-Laufzeit | SQL-Workflow-Laufzeit |
|---|---|
5 Sekunden | 5,25 Sekunden |
1 Sekunde | 1,25 Sekunden |
Häufig gestellte Fragen zum MongoDB-zu-MSSQL-Migrator
Die vollständigen Anweisungen zur Migration von MongoDB zu SQL finden Sie im Leitfaden zur Migration von MongoDB zu SQL. Lesen Sie sich die vollständigen Migrationsanweisungen durch, da bei diesen häufig gestellten Fragen nur die wichtigsten Aspekte behandelt werden.
1. Welche Version von Server kann ich auf 2024.1 aktualisieren, um umfassenden Support für die Migration (Mongo zu SQL) zu erhalten?
Server 2022.1+. Wenn Sie eine ältere Version als 2022.1 verwenden, empfehlen wir Ihnen, ein Upgrade auf eine Version zwischen 2022.1 und 2023.2 durchzuführen, bevor Sie auf 2024.1 aktualisieren.
2. Funktioniert der MongoDB-zu-MSSQL-Migrator für eingebettete Mongo-Datenbanken und für benutzerverwaltete Mongo-Datenbanken (Enterprise oder Atlas)?
Ja.
3. Ist die SQL-Migration Teil der 2024.1-Aktualisierung?
Nein, die SQL-Migration erfolgt über einen Workflow, den Sie nach der Aktualisierung auf 2024.1 ausführen können. Auf diese Weise können Sie auf 2024.1 aktualisieren und erste Tests durchführen, bevor Sie zu SQL migrieren.
4. Wo kann ich den SQL-Migrations-Workflow herunterladen?
5. Muss ich in 2024.1 zu SQL migrieren?
Nein. Dies ist eine optionale Migration. Wenn Sie in 2024.1 nicht zu SQL migrieren möchten, können Sie die Migration in einer zukünftigen Version durchführen.
6. Welche Datenbankgröße ist bei der Migration für SQL empfohlen?
Wir empfehlen, dass die SQL-DB doppelt so groß ist wie die vorhandene MongoDB. Dies liegt daran, dass Mongo die Datenbankgröße komprimiert und in MSSQL nicht dieselbe Komprimierung vorgenommen wird.
7. Muss der Dienst ausgeschaltet sein, damit die Migration ausgeführt werden kann?
Zum Testen können Sie den Migrator ausführen, während der Dienst ausgeführt wird. Löschen Sie nach dem Testen alle Datensätze (nicht Tabellen) aus der SQL-DB, bevor Sie die endgültige Migration ausführen. Fahren Sie den Dienst für die endgültige Migration vollständig herunter, und alle Datensätze werden jetzt übertragen.
8. Kann der Migrator gestoppt werden, bevor die Migration abgeschlossen ist? Was passiert, wenn die Migration unterbrochen wird?
Ja. Wenn der Migrator vor dem Abschluss unterbrochen oder gestoppt wird, beginnt er dort, wo er aufgehört hat, und setzt die Übertragung der Datensätze fort. Dies gilt nur, wenn der Dienst ausgeschaltet bleibt und während des Stoppzeitraums keine Änderungen an der Datenbank vorgenommen werden.
Wenn Sie die Migration stoppen, der Dienst gestartet wird und Änderungen an der MongoDB vorgenommen werden, müssen Sie den Inhalt der SQL-Tabellen löschen – jedoch nicht die Tabellen selbst –, bevor Sie den Migrator erneut ausführen.
9. Woher weiß ich, dass die Migration erfolgreich abgeschlossen wurde?
Im Ergebnisfenster werden keine Fehler angezeigt, und in den Protokollen werden alle Datensätze angezeigt, die von MongoDB zu MSSQL übertragen wurden.
10. Was sind die häufigsten Fehler, die bei der Durchführung der Migration auftreten könnten?
bcp_batch
Beispielfehlermeldung:
MongoToSQL_Migration_Macro (829): Migrator (22): Record #17: BatchTransferProcess (574): Record #1: Tool #9: Unable to find address for bcp_batch”Wann tritt der Fehler auf? Der Fehler wird während der Migration im Ergebnisfenster angezeigt.
Lösung: Stellen Sie sicher, dass der richtige SQL-Treiber installiert und konfiguriert ist (ODBC-SQL-Treiber 17).
Dienst konnte nach der Migration nicht gestartet werden
Beispielfehlermeldung (in Dienst-Protokollen):
ERROR,1,AlteryxServerMigrator,migrationLogger,ExecuteServerSqlDbMigrations,Server SQL database migrations have failed: Exception has been thrown by the target of an invocation.Wann tritt der Fehler auf?
Der Fehler wird nach der Migration in \Alteryx\Service\alteryx-migration.csv angezeigt.
Dieser Fehler kann auftreten, wenn Sie fälschlicherweise einen Treiber als Teil der Verbindungszeichenfolge für die Server-Benutzeroberfläche angeben.
Lösung:
Der AlteryxService muss mindestens einmal mit MongoDB als Backend gestartet werden, BEVOR Daten zu MSSQL migriert werden. Dadurch wird sichergestellt, dass das MongoDB-Schema korrekt aktualisiert wird.
Überprüfen Sie Ihre Verbindungszeichenfolgen. Achten Sie insbesondere darauf, dass Sie keinen Treiber in der Persistenzverbindungszeichenfolge der Server-Benutzeroberfläche angeben. Weitere Informationen finden Sie im Artikel zu erweiterten SQL DB-Verbindungszeichenfolgen.
Fehler bei der Konvertierung von Zeichenfolge in Zahl
Beispielfehlermeldung:
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 ''Wann tritt der Fehler auf? Der Fehler wird während der Migration im Ergebnisfenster angezeigt.
Lösung: Der AlteryxService muss mindestens einmal mit MongoDB als Backend gestartet werden, BEVOR Daten zu MSSQL migriert werden. Dadurch wird sichergestellt, dass das MongoDB-Schema korrekt aktualisiert wird.
AlteryxGallery.alteryx_server.Table_Name
Beispielfehlermeldung:
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.Wann tritt der Fehler auf? Der Fehler wird während der Migration im Ergebnisfenster angezeigt.
Lösung:
Stellen Sie sicher, dass das MongoDB-Schema in MongoDB VERÖFFENTLICHT wird, während Sie den Simba-Treiber einrichten.
Stellen Sie sicher, dass Sie die entsprechende Authentifizierungsquelle definieren, wenn Sie die DCM-Anmeldedaten für die verschiedenen Verbindungen erstellen. Um auf das Textfeld „Authentifizierungsquelle“ zuzugreifen, erweitern Sie den Abschnitt „Erweiterte Parameter“ unter den Eingaben für Benutzername und Kennwort, wenn Sie Ihre Anmeldedaten erstellen.
Wenn Sie die eingebettete MongoDB verwenden, sind zwei separate Anmeldedaten erforderlich: zum einen Daten, die die AlteryxService-Datenbank nutzen, und zum anderen Daten, die die AlteryxGallery-Datenbank als Authentifizierungsquelle nutzen. Weitere Informationen finden Sie im Leitfaden zur Migration von Mongo zu SQL.
Nicht autorisierter Befehl während der Einrichtung des MongoDB-Schemas
Beispielfehlermeldung:
[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)Wann tritt der Fehler auf? Beim Versuch, das MongoDB-Schema während der Einrichtung des Simba-Treibers zu veröffentlichen.
Lösung: Stellen Sie sicher, dass die Authentifizierungsdatenbank auf die Zieldatenbank eingestellt ist. Wenn Sie also den DSN-Eintrag für AlteryxGallery erstellen, setzen Sie die Authentifizierungsdatenbank auf „AlteryxGallery“ und nicht auf „Admin“.
11. Was muss ich tun, wenn die Migration fehlschlägt, und wie werde ich benachrichtigt?
Beim Fehlschlagen der Migration gibt der Workflow Fehlermeldungen aus. Melden Sie in diesem Fall den im Ergebnisfenster angezeigten Fehler Ihrem Support-Team und senden Sie alle während der Ausführung erstellten Screenshots und Protokolldateien mit.
Wenn die Migration fehlschlägt, können Sie AlteryxService erneut starten und Ihre MongoDB weiterhin verwenden. Zu diesem Zeitpunkt ist Mongo immer noch vollständig verbunden und funktionsfähig, sodass Sie keine zusätzlichen Schritte unternehmen müssen, um Mongo weiterhin verwenden zu können, wenn die Migration fehlschlägt.
12. Was passiert, wenn ich nach der Migration wieder MongoDB verwenden möchte?
Wenn Sie vor der Migration eine Sicherungskopie der Datei „RuntimeSettings.xml“ erstellt haben, können Sie die aktuelle Datei „RuntimeSettings.xml“ durch diese ersetzen (Sicherungskopien dieser beiden Dateien können hilfreich sein). Änderungen, die an Server vorgenommen wurden, während sie mit SQL verbunden waren, werden nach dem Wechsel zurück zu MongoDB allerdings nicht mehr dargestellt.
13. Werden durch die SQL-Migration Änderungen an der alten MongoDB vorgenommen?
Nein. Die Daten bleiben unverändert. Es wird aber eine Sammlung erstellt, um das Schema für die Simba-MongoDB-ODBC zu speichern.
14. Kann ich eine FIPS-Version von Server zu SQL migrieren?
Die Migration von MongoDB zu SQL wird für die FIPS-Umgebungen aktuell nicht unterstützt. Neue FIPS-Umgebungen können jedoch mit dem benutzerverwalteten MSSQL eingerichtet werden.