Mit REST-Datendiensten verbinden

Der Uniform Resource Identifier (URI) oder absolute Dateipfad der RESTful-Ressource.

Das zur Authentifizierung verwendete Schema. Folgende Authentifizierungsarten stehen zur Verfügung:

• Keine Authentifizierung Der Treiber nimmt keine Authentisierung vor.
• API-Schlüssel Der Treiber verwendet zur Authentifizierung einen API-Schlüssel.
• Bearertoken Der Treiber verwendet zur Authentifizierung einen Bearertoken.
• Standardauthentifizierung Der Treiber verwendet eine Standardauthentifizierung mit einem Benutzernamen und einem Kennwort.
• OAuth 1.0 Der Treiber verwendet zur Authentifizierung OAuth 1.0.
• OAuth 2.0 Der Treiber verwendet zur Authentifizierung OAuth 2.0.

Legt den API-Schlüssel zur Authentifizierung fest.

Dieses Feld ist aktiviert, falls Sie im Feld Autorisierungstyp den Wert API-Schlüssel ausgewählt haben.

Der Wert in diesem Feld wird mit dem angegebenen API-Schlüssel zur Authentifizierung am Server verwendet.

Dieses Feld ist aktiviert, falls Sie im Feld Autorisierungstyp den Wert API-Schlüssel ausgewählt haben.

Legt den Bearertoken für die Authentifizierung mit dem Server fest. Der Token kann ein Zugriffsschlüssel sein, wie der JSON Web Token, der im Anforderungsheader aufgenommen wird.

Dieses Feld ist aktiviert, falls Sie im Feld Autorisierungstyp Bearertoken ausgewählt haben.

Der Benutzername, der für eine Verbindung mit einer REST-Datenquelle verwendet wird.

Dieses Feld ist aktiviert, falls Sie im Feld Autorisierungstyp Standardauthentifizierung ausgewählt haben.

Das Kennwort für den Benutzernamen, der für eine Verbindung mit einer REST-Datenquelle verwendet wird.

Dieses Feld ist aktiviert, falls Sie im Feld Autorisierungstyp Standardauthentifizierung ausgewählt haben.

Der Bewilligungstyp für den OAuth-Fluss. Folgende Optionen sind verfügbar:

• CODE

• CLIENT

• PASSWORD

Diese Eigenschaft kann auf eine Zeichenfolge mit HTTP-Kopfzeilen eingestellt werden, die an die Kopfzeilen der HTTP-Anforderung anderer Eigenschaften, wie „Content-Type“, „From“ usw. angehängt werden sollen.

Die Kopfzeilen müssen das Format „Kopfzeile:Wert“ entsprechend den HTTP-Spezifikationen aufweisen. Jede Kopfzeile sollte eine eigene Zeile aufweisen.

Seien Sie mit dieser Option vorsichtig! Bei ungültigen Kopfzeilen können HTTP-Anforderungen scheitern. Diese Eigenschaft ist für eine Feinanpassung hilfreich, um spezialisierte oder nicht standardmäßige APIs zu integrieren.

Content-Type: text/html; charset=utf-8

Connection: keep-alive

Ausgeblendete Eigenschaften, die nur in spezifischen Anwendungsfällen erforderlich sind. Normalerweise müssen Sie hier nichts eingeben. Legen Sie mehrere Eigenschaften durch eine mit Semikolons getrennte Liste fest.

Konfiguration des Zwischenspeicherns

• CachePartial=True Nur eine Teilmenge der Spalten wird zwischengespeichert, die Sie in Ihrer Abfrage festlegen können.
• QueryPassthrough=True Übergibt die angegebene Abfrage an die Cache-Datenbank, anstatt den SQL-Parser des Treibers zu verwenden.

Integration und Formatierung

• Verknüpften Access-Modus unterstützen Im verknüpften Modus von Access empfiehlt es sich im Allgemeinen, immer einen Cache zu verwenden, da die meisten Datenquellen mehrere ID-Abfragen nicht unterstützen. Wenn Sie jedoch den Treiber in Access verwenden möchten, aber nicht im verknüpften Modus, muss diese Eigenschaft auf „Falsch“ eingestellt werden. Dadurch wird vermieden, dass ein Cache für eine Abfrage „SELECT *“ für die jeweilige Tabelle verwendet wird.
• Standard-Spaltengröße Legt die Standardlänge von Zeichenfolgenfeldern fest, falls die Datenquelle die Spaltenlänge nicht in den Metadaten angibt. Der Standardwert ist 2000.
• Datumzeit auf GMT konvertieren Legt fest, ob Datumzeit-Werte auf GMT (UTC) konvertiert werden sollen, also nicht die lokale Zeit des Computers verwendet wird.
• Speichern in Datei=Dateiname Speichert die Datenübertragung des zugrunde liegenden Sockets in die angegebene Datei.

OAuth-Eigenschaften

• OAuth initiieren Durch diese Eigenschaft wird bei einer Verbindung der Prozess eingeleitet, um den OAuth-Zugriffstoken abzurufen oder zu aktualisieren. Folgende Optionen sind verfügbar:

  • OFF Deutet an, dass Sie den OAuth-Fluss vollständig alleine handhaben. Ein OAuth-Zugriffstoke ist für die Authentifizierung erforderlich.

  • GETANDREFRESH Deutet an, dass der OAuth-Fluss vollständig durch den Treiber gehandhabt wird. Wenn gegenwärtig noch kein Token existiert, wird er abgerufen, was Ihnen über den Browser mitgeteilt wird. Wenn ein Token existiert, wird er gegebenenfalls aktualisiert.

  • REFRESH Deutet an, dass der Treiber nur das Aktualisieren des OAuth-Zugriffstokens handhabt. Sie werden durch den Treiber nie aufgefordert, sich über den Browser zu authentifizieren. Sie müssen den ursprünglichen Abruf des OAuth-Zugriffstokens und des OAuth-Aktualisierungstokens selbst erledigen.

• Speicherort OAuth-Einstellungen Der Speicherort der Einstellungsdatei, in der die OAuth-Werte gespeichert werden, falls „OAuth initiieren“ auf „Wahr“ eingestellt ist. Wenn „OAuth initiieren“ aktiviert ist, speichert der Treiber die OAuth-Werte in einer Einstellungsdatei, damit der Benutzer die OAuth-Verbindungseigenschaften nicht manuell eingeben muss. Sobald Ihre OAuth-Sitzung abläuft, wird der Treiber automatisch einen neuen Zugriffstoken abrufen, falls „OAuth initiieren“ eingestellt ist. Wenn „OAuth initiieren“ aktiviert, „Speicherort OAuth-Einstellungen“ aber nicht definiert ist, verwendet der Treiber in Windows eine Standardeinstellungsdatei %AppData%\CData\REST Data Provider\OAuthSettings.txt. In macOS befindet sich die Datei in ~/Library/Application Support/CData/REST Data Provider/OAuthSettings.txt. In Linux hier: ~/cdata/.config.

• OAuth-Zugriffstoken Der OAuth-Zugriffstoken wird vom OAuth-Server im Rahmen des Authentifizierungsvorgangs abgerufen. Er hat ein serverabhängiges Zeitlimit und kann zwischen Anforderungen wiederverwendet werden. Der Zugriffstoken wird statt Ihres Benutzernamens und Kennworts verwendet. Der Zugriffstoken schützt Ihre Anmeldeinformationen, indem diese auf dem Server bleiben.

• OAuth-Zugriffstoken-Geheimnis Das OAuth-Zugriffstoken-Geheimnis wird vom OAuth-Server im Rahmen des Authentifizierungsvorgangs abgerufen. Es wird mit dem OAuth-Zugriffstoken verwendet und kann bis zum Zeitlimit für mehrere Anfragen verwendet werden.

• OAuth-Aktualisierungstoken Die Eigenschaft „OAuth-Aktualisierungstoken“ wird verwendet, um im Rahmen der OAuth-Authentifizierung den OAuth-Zugriffstoken zu aktualisieren.

Legt das zu verwendende Datenmodell fest, falls Sie JSON- oder XML-Dokumente analysieren und Metadaten erstellen.

• Dokument Eine einzelne Tabelle, die eine Zeile pro Dokument repräsentiert, wird zurückgegeben. In diesem Datenmodell werden verschachtelte Dokumente (Objekt-Arrays) nicht vereinfacht und als Aggregate zurückgegeben. Falls ein XPath-Wert nicht explizit angegeben wird, wird der Treiber das oberste Dokument (Objekt-Array) identifizieren und als XPath verwenden.
• Vereinfachte Dokumente Eine einzelne Tabelle aus dem JOIN der verfügbaren Dokumente in der JSON- oder XML-Datei wird zurückgegeben. In diesem Datenmodell verhalten sich verschachtelte XPath-Werte genauso wie ein SQL JOIN. Verschachtelte XPath-Geschwisterwerte (untergeordnete Pfade auf derselben Höhe) werden als SQL CROSS JOIN behandelt. Solange sie nicht explizit festgelegt werden, wird der Treiber die verfügbaren XPath-Werte identifizieren, indem er die JSON- oder XML-Datei analysiert und die verfügbaren Dokumente erkennt (einschließlich verschachtelte Dokumente).
• Relational Es werden mehrere Tabellen zurückgegeben und zwar jeweils eine Tabelle pro festgelegtem XPath-Wert. In diesem Datenmodell werden verschachtelte Dokumente (Objekt-Arrays) als relationale Tabellen mit Primär- und Fremdschlüsseln zurückgegeben. Solange sie nicht explizit festgelegt werden, wird der Treiber die verfügbaren XPath-Werte identifizieren, indem er die JSON- oder XML-Datei analysiert und die verfügbaren Dokumente erkennt (einschließlich verschachtelte Dokumente).

Standardmäßig werden verschachtelte Arrays als JSON- oder XML-Zeichenfolgen zurückgegeben. Die Eigenschaft „Arrays vereinfachen“ kann verwendet werden, um die Elemente verschachtelter Arrays in eigene Spalten zu vereinfachen. Stellen Sie „Arrays vereinfachen“ auf die Anzahl der Elemente ein, die Sie aus verschachtelten Arrays zurückgeben möchten.

Wenn Sie „Arrays vereinfachen“ auf -1 einstellen, werden alle Elemente verschachtelter Arrays vereinfacht.

Gibt an, ob eine Schemadatei (RSD) aus dem analysierten Dokument erstellt werden soll.

• Nie Es wird nie eine Schemadatei (RSD) erstellt.
• Bei Verwendung Eine Schemadatei (RSD) wird bei der ersten Referenzierung einer Tabelle erstellt, falls die Schemadatei (RSD) für die Tabelle nicht bereits existiert.
• Beim Start Eine Schemadatei (RSD) wird zur Verbindungszeit für Tabellen erstellt, die bisher keine Schemadatei (RSD) haben.

Diese Eigenschaft wird zusammen mit „Format“, „URI“, „XPath“ und „Speicherort“ verwendet.

Der XPath eines Elements, das auf derselben Höhe im XML-/JSON-Dokument wiederholt wird (wird verwendet, um das Dokument in mehrere Zeilen aufzuteilen).

Mehrere Pfade können über eine durch Semikolons getrennte Liste festgelegt werden. Die Einstellung „Datenmodell“ ermöglicht Ihnen zu konfigurieren, wie XPath-Werte zur Erstellung von Tabellen und der Anzeige von Daten verwendet werden.

Die Anzahl der zu scannenden Zeilen, wenn die Spalten der Tabelle dynamisch festgestellt werden. Spalten werden dynamisch festgestellt, falls eine Schemadatei (RSD) für die Tabelle nicht verfügbar ist, beispielsweise wenn „Schemadateien erstellen“ verwendet wird. Höhere Werte ergeben eine längere Anfrage, werden jedoch genauer sein.

Wenn Sie diesen Wert auf „0“ (Null) einstellen, wird das gesamte Dokument analysiert.

Wenn Sie eine TLS/SSL-Verbindung verwenden, kann diese Eigenschaft verwendet werden, um das TLS/SSL-Zertifikat festzulegen, das durch den Server akzeptiert wird. Andere Zertifikate, denen der Computer nicht vertraut, werden abgelehnt.

Bei einer fehlenden Angabe wird jedes Zertifikat akzeptiert, dem der Computer vertraut.

Verwenden Sie '*', falls Sie alle Zertifikate akzeptieren möchten (aus Sicherheitsgründen nicht empfohlen).

• -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
• C:\cert.cer
• -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
• ecadbdda5a1529c58a1e9e09828d70e4
• 34a929226ae0819f2ec14b4a3d904f801cbb150d

Die maximale Länge einer Primärschlüsselspalte.

In einigen ODBC-Tools darf die Länge der Primärschlüsselspalte nicht länger als ein spezifischer Wert sein. Durch diese Eigenschaft überschreibt der ODBC-Treiber die gemeldete Länge aller Primärschlüsselspalten. Dies ist besonders hilfreich, wenn der ODBC-Treiber als eine verknüpfte Microsoft-Access-Datenquelle verwendet wird.

Wenn „Grenze der Schlüsselgröße“ auf Null eingestellt wird, wird die ursprüngliche Schlüssellänge wiederhergestellt.

Diese Eigenschaft kontrolliert, ob eine Spalte als SQL_LONGVARCHAR zurückgegeben wird.

Einige Anwendungen verlangen, dass alle Textdaten, die eine bestimmte Zeichenanzahl überschreiten, als SQL_LONGVARCHAR gemeldet werden. Verwenden Sie diese Eigenschaft, um alle Spalten über einer bestimmten Größe so zuzuordnen, dass sie als SQL_LONGVARCHAR statt SQL_VARCHAR gemeldet werden.

Gibt an, ob Pseudospalten der Tabelle ebenfalls als Spalten hinzugefügt werden sollen.

Diese Einstellung ist besonders im Entity Framework hilfreich, das Ihnen nicht ermöglicht, einen Wert für eine Pseudospalte anzugeben, solange sie keine Tabellenspalte ist.

Sie können das Sternchen („*“) verwenden, um alle Tabellen und alle Spalten einzuschließen. Beispiel: „*=*“.

Tabelle1=Spalte1; Tabelle1=Spalte2; Tabelle2=Spalte3

Dieser Wert legt den Authentifizierungstyp fest, der für die Authentifizierung mit dem HTTP-Proxy (angegeben durch „Proxy-Server“ und „Proxy-Port“) zu verwenden ist.

Beachten Sie, dass der Treiber standardmäßig die Proxy-Einstellungen des Systems verwenden wird, sodass keine weitere Konfiguration notwendig ist. Wenn Sie sich mit einem anderen Proxy verbinden möchten, müssen Sie zusätzlich zur Angabe von „Proxy-Server“ und „Proxy-Port“ den Wert von „Autom. Proxy-Erkennung“ auf „falsch“ setzen. Zur Authentifizierung stellen Sie „Authentifizierung für Proxy“ ein und geben bei Bedarf „Proxy-Benutzer“ und „Proxy-Kennwort“ an.

Es gibt folgende Authentifizierungstypen:

• BASIC Der Treiber führt eine HTTP-BASIC-Authentifizierung durch.
• DIGEST Der Treiber führt eine HTTP-DIGEST-Authentifizierung durch.
• KEINE
• NEGOTIATE In Abhängigkeit vom zutreffenden Authentifizierungsprotokoll ruft der Treiber einen NTLM- oder Kerberos-Token ab.
• NTLM
• PROPRIETARY Der Treiber generiert keinen NTLM- oder Kerberos-Token. Sie müssen diesen Token im Autorisierungskopf der HTTP-Anforderung angeben.

Der SSL-Typ, der für die Verbindung mit dem unter „Proxy-Server“ angegebenen Proxy zu verwenden ist.

• AUTO Standardeinstellung. Wenn die URL eine HTTPS-URL ist, wird der Treiber die TUNNEL-Option verwenden. Wenn die URL eine HTTP-URL ist, wird die Komponente die Option „NEVER“ verwenden.
• ALWAYS Für die Verbindung ist stets SSL aktiviert.
• NEVER Für die Verbindung ist SSL nicht aktiviert.
• TUNNEL Die Verbindung erfolgt durch einen Tunneling-Proxy: Der Proxy-Server öffnet eine Verbindung mit dem Remote-Host und der Datenverkehr fließt durch den Proxy.

Eine durch Semikolons getrennte Liste von Hosts oder IPs, die von einer Verbindung über den Proxy-Server ausgenommen sind.

Der Treiber wird standardmäßig die Proxy-Einstellungen des Systems verwenden, sodass keine weitere Konfiguration notwendig ist. Wenn Sie explizit Proxy-Ausnahmen für diese Verbindung konfigurieren möchten, müssen Sie „Proxy-Server“ und „Proxy-Port“ konfigurieren und den Wert von „Autom. Proxy-Erkennung“ auf „falsch“ setzen. Zur Authentifizierung stellen Sie „Authentifizierung für Proxy“ ein und geben bei Bedarf „Proxy-Benutzer“ und „Proxy-Kennwort“ an.