Benutzerhandbuch für TIBCO Cloud™ Spotfire®-Webclient

Zugriff auf Daten aus Microsoft SQL Server

Mit dem Daten-Connector für Microsoft SQL Server können Sie eine Verbindung zu Microsoft SQL Server-Systemen herstellen und auf deren Daten zugreifen. Auf dieser Seite finden Sie Informationen zu den Funktionen, den verfügbaren Einstellungen und den Besonderheiten, die Sie beachten sollten, wenn Sie mit Datenverbindungen zu Microsoft SQL Server arbeiten.

Seiteninhalt

Connector-Funktionen

Die folgenden Funktionen sind verfügbar, wenn Sie mit dem Connector für Microsoft SQL Server auf Daten zugreifen.

Funktion Unterstützt?
Ladenmethoden
  • Importieren (speicherintern)
  • Extern (datenbankintern)
  • Bei Bedarf
Benutzerdefinierte Abfragen Ja
Gespeicherte Prozeduren Ja
Benutzerdefinierte Verbindungseigenschaften Ja
Single-Sign-on mit Identitätsanbieter Ja
Dokumenterstellung im Webclient Ja
Unterstützt auf Linux Web Player Ja

Datenquelleneigenschaften

Im Folgenden sind die unterstützten Datenquelleneigenschaften aufgeführt, die Sie konfigurieren können, wenn Sie eine Datenverbindung mit dem Connector für Microsoft SQL Server erstellen.

Anmerkung: Weitere Informationen zu den Eigenschaften und den entsprechenden Einstellungen in der Treibersoftware finden Sie in der offiziellen Dokumentation von Microsoft zum .NET-Datenanbieter für SQL Server.
Option Beschreibung
Server

Der Name des Servers, auf dem sich Ihre Daten befinden. Wenn Sie eine Portnummer angeben möchten, fügen Sie die Nummer durch ein Komma getrennt direkt nach dem Namen hinzu. Um einen Instanzennamen anzugeben, fügen Sie ihn durch einen umgekehrten Schrägstrich getrennt direkt nach dem Namen hinzu.

Beispiel mit Portnummer: MyDatabaseServer,1234

Beispiel mit Instanzenname: MyDatabaseServer\InstanceName

Datenbank

Bestimmt, wie Sie auswählen, auf welche Datenbank zugegriffen werden soll.

Aus Liste auswählen

Treffen Sie in einer Liste aller verfügbaren Datenbanken im Dropdownmenü „Datenbank“ eine Auswahl. Das Dropdownmenü „Datenbank“ wird aufgefüllt, nachdem Sie auf „Verbinden“ geklickt haben.

Hinweis: Um die Option „Aus Liste auswählen“ zu verwenden, müssen Sie Zugriff auf die Standarddatenbank in der Datenquelle haben. Die Standarddatenbank wird häufig als „Master“ bezeichnet.

Namen eingeben

Geben Sie manuell den Namen der Datenbank ein, auf die Sie zugreifen möchten.

Authentifizierungsmethode

Die Authentifizierungsmethode für die Anmeldung bei der Datenbank.

Windows-Authentifizierung

Bei der Windows-Authentifizierung (z. B. Kerberos) wird das Zugriffstoken des angemeldeten Benutzers verwendet. Benutzer mit den entsprechenden Zugriffsrechten für SQL Server können eine Verbindung herstellen und Daten lesen.

Domänenanmeldeinformationen werden nicht in der Analysedatei gespeichert.

SQL Server-Authentifizierung

Bei der Datenbankauthentifizierung erfolgt die Authentifizierung anhand eines Datenbankbenutzers. Datenbank-Anmeldeinformationen können mit einer Einstellung im Dialogfeld „Datenquelleneinstellungen“ unverschlüsselt als Bestandteil der Analysedatei gespeichert werden. In der Analysedatei gefundene Anmeldeinformationen werden für die automatische Authentifizierung bei der Datenbank verwendet.

Werden keine Anmeldeinformationen oder Anmeldeinformationsprofile in der Analysedatei gefunden, werden alle Benutzer, die die Datei öffnen, zur Eingabe von Datenbank-Anmeldeinformationen aufgefordert.

Beachten Sie, dass die Aufforderung zur Eingabe von Anmeldeinformationen nicht erfolgt, wenn die in der Analysedatei eingebetteten Anmeldeinformationen fehlerhaft sind.

Active Directory - Integriert

[Diese Authentifizierungsmethode wird nicht unterstützt, wenn Sie die Datenverbindung in einem Spotfire-Webclient öffnen, der auf einem Linux-System ausgeführt wird.]

Wenn Sie Active Directory verwenden und Ihre Domäne mit Azure Active Directory verknüpft ist, können Sie eine Verbindung zur Microsoft Azure SQL-Datenbank herstellen und sich mit Ihren angemeldeten Azure Active Directory-Anmeldeinformationen authentifizieren. Wählen Sie die Authentifizierungsmethode „Active Directory – Integriert“ aus.

Mit dieser Authentifizierungsmethode können keine Anmeldeinformationen in der Analysedatei gespeichert werden.

Active Directory – Kennwort

Geben Sie Ihren Azure Active Directory-Hauptbenutzernamen und Ihr Kennwort für die Authentifizierung bei der Microsoft Azure SQL-Datenbank ein.

Verwenden Sie die Authentifizierung vom Typ „Active Directory – Kennwort“ nur zum Herstellen einer Verbindung zur Microsoft Azure SQL-Datenbank.

Identitätsanbieter (OAuth2)

Verwenden Sie zum Anmelden einen Identitätsanbieter wie Okta oder Keycloak. Beim Öffnen der Datenverbindung wird ein Webbrowser-Fenster geöffnet, und Sie melden sich mit dem Anmeldeverfahren des Identitätsanbieters an.

Verschlüsseln

Aktivieren Sie dieses Kontrollkästchen, um festzulegen, dass bei der Verbindung mit dem SQL Server eine Verschlüsselung verwendet wird. Standardmäßig ist „Verschlüsseln“ aktiviert.

Server vertrauen

[Gilt nur bei Auswahl von „Verschlüsseln“.]

Wenn Sie mithilfe der Verschlüsselung eine Verbindung mit einem SQL-Server herstellen möchten, der über kein überprüfbares Serverzertifikat verfügt (z. B. wenn er ein selbstsigniertes Zertifikat verwendet), können Sie dieses Kontrollkästchen aktivieren, um dem Server zu vertrauen und eine Verbindung ohne Validierung des Serverzertifikats herzustellen.

Zeitüberschreitung Verbindung (s)

Die maximale Zeit in Sekunden, die für das Herstellen einer Verbindung zur Datenbank zulässig ist.

Sie können diese Zeitüberschreitung auch als Einstellung im Verwaltungs-Manager festlegen. Sie wird verwendet, wenn Sie im Verbindungsdialogfeld keine Zeitüberschreitung festlegen.

Wenn Sie im Verbindungsdialogfeld eine Zeitüberschreitung festlegen, überschreibt dieser Wert die Einstellungen in der Verwaltungs-Manager-Einstellung. Wenn Sie weder im Verbindungsdialogfeld noch in der Einstellung eine Zeitüberschreitung angeben, wird der Standardwert von 120 Sekunden verwendet.

Hinweis: Wenn Sie Zeitüberschreitung für Verbindungen auf null festlegen, wird dies nicht als Zeitüberschreitung interpretiert. Bei dieser Vorgehensweise gibt es kein oberes Limit für das Ausführen eines Befehls. Dieses Verfahren wird generell nicht empfohlen.

Befehlszeitüberschreitung (s)

Die maximale Zeit in Sekunden, die für die Ausführung eines Befehls zulässig ist.

Sie können diese Zeitüberschreitung auch als Einstellung im Verwaltungs-Manager festlegen. Sie wird verwendet, wenn Sie im Verbindungsdialogfeld keine Zeitüberschreitung festlegen.

Wenn Sie im Verbindungsdialogfeld eine Zeitüberschreitung festlegen, überschreibt dieser Wert die Einstellungen in der Verwaltungs-Manager-Einstellung. Wenn Sie weder im Verbindungsdialogfeld noch in der Einstellung eine Zeitüberschreitung angeben, wird der Standardwert von 1.800 Sekunden verwendet.

Hinweis: Wenn Sie Zeitüberschreitung für Befehle auf null festlegen, wird dies nicht als Zeitüberschreitung interpretiert. Bei dieser Vorgehensweise gibt es kein oberes Limit für das Ausführen eines Befehls. Dieses Verfahren wird generell nicht empfohlen.

Benutzerdefinierte Eigenschaften für Microsoft SQL Server-Verbindungsdatenquellen

Im Folgenden finden Sie die Standardliste der Treibereinstellungen, die als benutzerdefinierte Eigenschaften in Microsoft SQL Server-Verbindungsdatenquellen zulässig sind. Informationen zum Ändern der zulässigen benutzerdefinierten Eigenschaften finden Sie unter Steuern, welche Eigenschaften zulässig sind.

Standardmäßig zulässige benutzerdefinierte Eigenschaften

ApplicationIntent, Attestation Protocol, Column Encryption Setting, ConnectRetryCount, ConnectRetryInterval, Enclave Attestation Url, Enlist, Failover Partner, FailoverPartnerSPN, HostNameInCertificate, IPAddressPreference, Load Balance MultiSubnetFailoverTimeout, Max Pool Size, Min Pool Size, MultipleActiveResultSets, , Packet Size, PoolBlockingPeriod, Pooling, ServerCertificate, ServerSPN, Transaction Binding, Type System Version, User Instance, Workstation ID

SQL Server-Datentypen

Wenn Sie eine Verbindung zu einer externen Datenquelle einrichten, muss Spotfire die Datentypen in der Datenquelle den Datentypen in Spotfire zuordnen. Unten finden Sie eine Liste der verschiedenen Datentypen, die von Spotfire unterstützt werden, sowie die angewendeten Datentypzuordnungen bei der Arbeit mit einer SQL Server-Datenbank.

SQL Server-Datentyp Spotfire-Datentyp
BINARY Binary
GEOGRAFIE Binary
GEOMETRIE Binary
IMAGE Binary
ROWVERSION Binary
TIMESTAMP Binary
VARBINARY Binary
BIT Boolean
DECIMAL Currency
MONEY Currency
NUMERIC Currency
SMALLMONEY Currency
DATE Date
DATETIME DateTime
DATETIME2 DateTime
SMALLDATETIME DateTime
INT Integer
SMALLINT Integer
TINYINT Integer
BIGINT LongInteger
FLOAT Real
REAL SingleReal
CHAR String
NCHAR String
NTEXT String
NVARCHAR String
TEXT String
UNIQUEIDENTIFIER String
VARCHAR String
TIME Time

Unterstützte Funktionen

Unterstützte Funktionen sind die Funktionen, die Sie verwenden können, wenn Sie mit datenbankinternen Datentabellen arbeiten, z. B. für berechnete Spalten und benutzerdefinierte Ausdrücke.

Anmerkung: Einige unterstützte Funktionen können möglicherweise nicht mit Ihrer Datenbank verwendet werden. Dies hängt davon ab, welche Funktionen in der Datenbank verfügbar sind. Diese unterscheiden sich häufig zwischen Datenbankversionen und -typen.

Die folgenden Funktionen werden vom Microsoft SQL Server-Connector unterstützt.

Funktionstyp Unterstützte Funktionen
Datum und Uhrzeit Year, Quarter, Month, Week, Day, DayOfMonth, DayOfYear, DayOfWeek, Hour, Minute, Second, Millisecond
Konvertierung SN
Mathematik Abs, ASin, ACos, ATan, Atn2, Ceiling, Cos, Sin, Tan, Cot, Exp, Floor, Log, Log10, Power, Sqrt, Square
Operatoren +, -, *, /, %
Statistisch Sum, Avg, Max, Min, Count, UniqueCount, Count_Big, Stdev, StdevP, Var, VarP
Text CharIndex, Len, Lower, Upper, LTrim, RTrim, Soundex, Reverse, Split

Arbeiten mit Microsoft SQL Server-Datenverbindungen

Im Folgenden finden Sie Informationen speziell zum Arbeiten mit Daten aus einer Microsoft SQL Server-Verbindung in Spotfire.

Telemetrie – Abfrage-Tagging

Wenn Sie eine Verbindung mit dem Connector für Microsoft SQL Server herstellen, werden der Name der Spotfire-Anwendung und die Versionsnummer als Telemetrie-Tag zur Verbindungszeichenfolge hinzugefügt.