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.
Wir unterstützen offiziell MSSQL Server 2019 und 2022 sowie Amazon RDS für SQL Server.
Ja. Amazon RDS für SQL Server wird unterstützt.
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.
Nein, derzeit bieten wir nur MSSQL als Datenbankoption für benutzerverwaltete Datenbanken an.
Ja.
Ja.
Ja.
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.
Nein, diese DBs können sich am selben Ort befinden.
Ja.
Ja.
Ja, Sie können eine SQL-Server-Instanz neben anderen Datenbankinstanzen ausführen.
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 |
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.
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.
Ja.
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.
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.
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.
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.
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.
Im Ergebnisfenster werden keine Fehler angezeigt, und in den Protokollen werden alle Datensätze angezeigt, die von MongoDB zu MSSQL übertragen wurden.
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“.
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.
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.
Nein. Die Daten bleiben unverändert. Es wird aber eine Sammlung erstellt, um das Schema für die Simba-MongoDB-ODBC zu speichern.
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.