Microsoft OneDrive Verbindungsdetails
Einführung
Connector-Version
Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.
Erste Schritte
Versionsunterstützung für Microsoft OneDrive
Microsoft OneDrive und OneDrive for Business-Konten werden über die Microsoft Graph API v1.0 unterstützt.
Herstellen einer Verbindung
Mit Microsoft OneDrive verbinden
Authentifizieren mit dem Microsoft Entra-Dienstprinzipal
Azure Service Principal ist ein Verbindungstyp, der über OAuth läuft. Legen Sie Ihre AuthScheme
Zu AzureServicePrincipal
und siehe Verwenden der Microsoft Entra-Dienstprinzipalauthentifizierung für eine Anleitung zur Authentifizierung.
Microsoft Entra-Dienstprinzipal verwenden
Microsoft Entra-Dienstprinzipal
Azure Service Principal ist eine rollenbasierte, anwendungsbasierte Authentifizierung. Dies bedeutet, dass die Authentifizierung pro Anwendung und nicht pro Benutzer erfolgt. Alle von der App ausgeführten Aufgaben werden ohne Standardbenutzerkontext, sondern basierend auf den zugewiesenen Rollen ausgeführt. Der Anwendungszugriff auf die Ressourcen wird über die Berechtigungen der zugewiesenen Rollen gesteuert.
Um die Dienstprinzipalauthentifizierung von Microsoft Entra zu verwenden, müssen Sie:
-
Richten Sie die Möglichkeit ein, der Authentifizierungsanwendung eine Rolle zuzuweisen. Erstellen Sie dazu eine benutzerdefinierte OAuth AD-Anwendung, wie in
Erstellen einer benutzerdefinierten OAuth-Anwendung
Microsoft OneDrive unterstützt die Authentifizierung mit Microsoft Entra ID und Microsoft Entra Service Principal, die beide auf OAuth basieren.
In diesem Thema wird Folgendes beschrieben:
- Erstellen und Registrieren einer benutzerdefinierten OAuth-Anwendung für die Microsoft Entra ID oder den Microsoft Entra-Dienstprinzipal
- Erteilen Sie einer benutzerdefinierten OAuth-Anwendung die Administratorzustimmung
Microsoft Entra ID
In
portal.azure.com
:- Melden Sie sich an bei
https://portal.azure.com
. - Wählen Sie im linken Navigationsbereich
Microsoft Entra ID
, DannapplicationRegistrations
. - Klicken Sie auf
New registration
. - Geben Sie einen Namen für die Anwendung ein.
- Wählen Sie die gewünschte Mandantenkonfiguration aus: Einzel- oder Mehrmandant und öffentliche oder private Nutzung.
- Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die festlegen
AzureTenant
Verbindungseigenschaft auf die ID des Microsoft Entra ID Tenants, wenn eine Verbindung mit dem Microsoft OneDrive Connector hergestellt wird. Andernfalls schlägt der Authentifizierungsversuch mit einem Fehler fehl. - Wenn Ihre Anwendung nur für den privaten Gebrauch bestimmt ist, geben Sie an
Accounts in this organization directory only
. - Wenn Sie Ihre Anwendung verteilen möchten, wählen Sie eine der Multi-Tenant-Optionen.
- Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die festlegen
- Setzen Sie die Weiterleitungs URL auf
http://localhost:33333
(Standard des Connectors) ODER geben Sie einen anderen Port an und setzen SieCallbackURL
an die genaue Antwort-URL, die Sie definiert haben. - Klicken Sie auf
Register
, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
Notieren Sie den Wert inApplication (client) ID
alsOAuthClientId
und dasDirectory (tenant) ID
alsAzureTenant
. - Navigieren Sie zu
Certificates & Secrets
und definieren Sie den Authentifizierungstyp der Anwendung. Es stehen zwei Authentifizierungsarten zur Verfügung: Zertifikat (empfohlen) oder Client-Geheimnis.- Für die Zertifikatsauthentifizierung: In
Certificates & Secrets
, wählenUpload certificate
, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch. - Zum Erstellen eines neuen Client-Geheimnisses: In
Certificates & Secrets
, wählenNew Client Secret
für die Anwendung und geben Sie deren Dauer an. Nachdem das Clientgeheimnis gespeichert wurde, zeigt Microsoft OneDrive den Schlüsselwert an. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird. Dieser Wert wird zumOAuthClientSecret
.
- Für die Zertifikatsauthentifizierung: In
- Wählen Sie
API Permissions > Add > Delegated permissions
. - Wählen Sie die Microsoft Graph API aus und fügen Sie dann die delegierten Berechtigungen Files.ReadWrite.All oder Files.Read.All hinzu. Klicken Sie anschließend auf die Schaltfläche „Administratorzustimmung erteilen“, damit die neuen Berechtigungen wirksam werden.
- Speichern Sie Ihre Änderungen.
- Wenn Sie die Verwendung von Berechtigungen angegeben haben, die die Zustimmung des Administrators erfordern, können Sie diese vom aktuellen Mandanten aus auf der Seite „API Berechtigungen“ erteilen.
Microsoft Entra-Dienstprinzipal
Um die Microsoft Entra-Dienstprinzipalauthentifizierung zu verwenden, müssen Sie die Möglichkeit einrichten, der Authentifizierungsanwendung eine Rolle zuzuweisen, und dann eine Anwendung beim Microsoft Entra ID Mandanten registrieren, um einen neuen Dienstprinzipal zu erstellen. Dieser neue Dienstprinzipal kann dann den zugewiesenen rollenbasierten Zugriff nutzen.
Kontrolle über den Zugriff auf Ressourcen in Ihrem Abonnement.
In
portal.azure.com
:- Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
- Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
- Öffnen Sie die
Subscriptions
-Seite. - Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
- Öffnen Sie die
Access control (IAM)
. - Wählen Sie
Add > Add role assignment
. Microsoft OneDrive öffnet dasAdd role assignment
Seite. - Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu
Owner
.
Administratorzustimmung
Für einige benutzerdefinierte Anwendungen sind Administratorberechtigungen erforderlich, um innerhalb eines Microsoft Entra ID Mandanten ausgeführt zu werden. Die Administratorzustimmung kann beim Erstellen einer neuen benutzerdefinierten OAuth-Anwendung erteilt werden, indem relevante Berechtigungen hinzugefügt werden, die bereits mit „Administratorzustimmung erforderlich“ gekennzeichnet sind. Die Administratorzustimmung ist auch erforderlich, um Clientanmeldeinformationen im OAuth-Flow zu verwenden.
So erteilen Sie die Administratorzustimmung:
- Lassen Sie einen Administrator sich anmelden bei
portal.azure.com
. - Navigieren Sie zu
App Registrations
und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben. - Unter
API Permissions
, klickGrant Consent
.
Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.
.
- Registrieren Sie eine Anwendung mit einem Microsoft Entra ID Mandanten, um einen neuen Dienstprinzipal zu erstellen, der mit der rollenbasierten Zugriffssteuerung verwendet werden kann, um auf Ressourcen in Ihrem Abonnement zuzugreifen.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie eine benutzerdefinierte Microsoft Entra ID Anwendung, wie in
Erstellen einer benutzerdefinierten OAuth-Anwendung
Microsoft OneDrive unterstützt die Authentifizierung mit Microsoft Entra ID und Microsoft Entra Service Principal, die beide auf OAuth basieren.
In diesem Thema wird Folgendes beschrieben:
- Erstellen und Registrieren einer benutzerdefinierten OAuth-Anwendung für die Microsoft Entra ID oder den Microsoft Entra-Dienstprinzipal
- Erteilen Sie einer benutzerdefinierten OAuth-Anwendung die Administratorzustimmung
Microsoft Entra ID
In
portal.azure.com
:- Melden Sie sich an bei
https://portal.azure.com
. - Wählen Sie im linken Navigationsbereich
Microsoft Entra ID
, DannapplicationRegistrations
. - Klicken Sie auf
New registration
. - Geben Sie einen Namen für die Anwendung ein.
- Wählen Sie die gewünschte Mandantenkonfiguration aus: Einzel- oder Mehrmandant und öffentliche oder private Nutzung.
- Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die festlegen
AzureTenant
Verbindungseigenschaft auf die ID des Microsoft Entra ID Tenants, wenn eine Verbindung mit dem Microsoft OneDrive Connector hergestellt wird. Andernfalls schlägt der Authentifizierungsversuch mit einem Fehler fehl. - Wenn Ihre Anwendung nur für den privaten Gebrauch bestimmt ist, geben Sie an
Accounts in this organization directory only
. - Wenn Sie Ihre Anwendung verteilen möchten, wählen Sie eine der Multi-Tenant-Optionen.
- Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die festlegen
- Setzen Sie die Weiterleitungs URL auf
http://localhost:33333
(Standard des Connectors) ODER geben Sie einen anderen Port an und setzen SieCallbackURL
an die genaue Antwort-URL, die Sie definiert haben. - Klicken Sie auf
Register
, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
Notieren Sie den Wert inApplication (client) ID
alsOAuthClientId
und dasDirectory (tenant) ID
alsAzureTenant
. - Navigieren Sie zu
Certificates & Secrets
und definieren Sie den Authentifizierungstyp der Anwendung. Es stehen zwei Authentifizierungsarten zur Verfügung: Zertifikat (empfohlen) oder Client-Geheimnis.- Für die Zertifikatsauthentifizierung: In
Certificates & Secrets
, wählenUpload certificate
, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch. - Zum Erstellen eines neuen Client-Geheimnisses: In
Certificates & Secrets
, wählenNew Client Secret
für die Anwendung und geben Sie deren Dauer an. Nachdem das Clientgeheimnis gespeichert wurde, zeigt Microsoft OneDrive den Schlüsselwert an. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird. Dieser Wert wird zumOAuthClientSecret
.
- Für die Zertifikatsauthentifizierung: In
- Wählen Sie
API Permissions > Add > Delegated permissions
. - Wählen Sie die Microsoft Graph API aus und fügen Sie dann die delegierten Berechtigungen Files.ReadWrite.All oder Files.Read.All hinzu. Klicken Sie anschließend auf die Schaltfläche „Administratorzustimmung erteilen“, damit die neuen Berechtigungen wirksam werden.
- Speichern Sie Ihre Änderungen.
- Wenn Sie die Verwendung von Berechtigungen angegeben haben, die die Zustimmung des Administrators erfordern, können Sie diese vom aktuellen Mandanten aus auf der Seite „API Berechtigungen“ erteilen.
Microsoft Entra-Dienstprinzipal
Um die Microsoft Entra-Dienstprinzipalauthentifizierung zu verwenden, müssen Sie die Möglichkeit einrichten, der Authentifizierungsanwendung eine Rolle zuzuweisen, und dann eine Anwendung beim Microsoft Entra ID Mandanten registrieren, um einen neuen Dienstprinzipal zu erstellen. Dieser neue Dienstprinzipal kann dann den zugewiesenen rollenbasierten Zugriff nutzen.
Kontrolle über den Zugriff auf Ressourcen in Ihrem Abonnement.
In
portal.azure.com
:- Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
- Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
- Öffnen Sie die
Subscriptions
-Seite. - Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
- Öffnen Sie die
Access control (IAM)
. - Wählen Sie
Add > Add role assignment
. Microsoft OneDrive öffnet dasAdd role assignment
Seite. - Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu
Owner
.
Administratorzustimmung
Für einige benutzerdefinierte Anwendungen sind Administratorberechtigungen erforderlich, um innerhalb eines Microsoft Entra ID Mandanten ausgeführt zu werden. Die Administratorzustimmung kann beim Erstellen einer neuen benutzerdefinierten OAuth-Anwendung erteilt werden, indem relevante Berechtigungen hinzugefügt werden, die bereits mit „Administratorzustimmung erforderlich“ gekennzeichnet sind. Die Administratorzustimmung ist auch erforderlich, um Clientanmeldeinformationen im OAuth-Flow zu verwenden.
So erteilen Sie die Administratorzustimmung:
- Lassen Sie einen Administrator sich anmelden bei
portal.azure.com
. - Navigieren Sie zu
App Registrations
und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben. - Unter
API Permissions
, klickGrant Consent
.
Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.
.
- Weisen Sie der Anwendung eine Rolle zu:
- Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
- Öffnen Sie die
Subscriptions
-Seite. - Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
- Öffnen Sie die
Access control (IAM)
. - Wählen Sie
Add > Add role assignment
. Microsoft OneDrive öffnet dasAdd role assignment
Seite. - Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu
Owner
.
Zustimmung des Administrators
Die Administratorzustimmung erfolgt, wenn der Administrator für einen Microsoft Entra ID Mandanten Berechtigungen für eine benutzerdefinierte Anwendung erteilt, für die ausdrücklich die Zustimmung eines Administrators zum Anwendungsfall erforderlich ist.
Wenn Sie im Azure-Portal eine neue Microsoft Entra ID Anwendung erstellen, müssen Sie angeben, welche Berechtigungen die Anwendung benötigt. Einige Berechtigungen können als „Administratorzustimmung erforderlich“ gekennzeichnet sein. Beispielsweise erfordern alle Gruppenberechtigungen die Administratorzustimmung. Wenn Ihre Anwendung die Administratorzustimmung erfordert, können Sie dies auf zwei Arten tun.
Der einfachste Weg, die Administrator-Zustimmung zu erteilen, besteht darin, dass sich ein Administrator anmeldet portal.azure.com
und navigieren Sie zu der Anwendung, die Sie in App-Registrierungen erstellt haben. Unter API Permissions
, klick Grant Consent
. Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.
Wenn Ihre Organisation mehrere Mandanten hat oder Sie Anwendungsberechtigungen für andere Mandanten außerhalb Ihrer Organisation erteilen müssen, verwenden Sie GetAdminConsentURL gespeicherte Prozedur zum Generieren der Admin-Autorisierungs URL. Im Gegensatz zur GetOAuthAuthorizationURL gespeicherte Prozedur werden von diesem Endpoint keine wichtigen Informationen zurückgegeben. Stattdessen gibt die OAuth-Anwendung nach erfolgreicher Autorisierung einen Boolean-Wert zurück, der angibt, dass Berechtigungen erteilt wurden.
Nachdem der Administrator die OAuth-Anwendung genehmigt hat, können Sie mit der Authentifizierung fortfahren.
Erstellen einer benutzerdefinierten OAuth-Anwendung
Erstellen einer benutzerdefinierten OAuth-Anwendung
Microsoft OneDrive unterstützt die Authentifizierung mit Microsoft Entra ID und Microsoft Entra Service Principal, die beide auf OAuth basieren.
In diesem Thema wird Folgendes beschrieben:
- Erstellen und Registrieren einer benutzerdefinierten OAuth-Anwendung für die Microsoft Entra ID oder den Microsoft Entra-Dienstprinzipal
- Erteilen Sie die Administratorzustimmung für eine benutzerdefinierte OAuth-Anwendung
Microsoft Entra ID
In portal.azure.com
:
- Melden Sie sich an bei
https://portal.azure.com
. - Wählen Sie im linken Navigationsbereich
Microsoft Entra ID
, DannapplicationRegistrations
. - Klicken Sie auf
New registration
. - Geben Sie einen Namen für die Anwendung ein.
- Wählen Sie die gewünschte Mandantenkonfiguration aus: Einzel- oder Mehrmandant und öffentliche oder private Nutzung.
- Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die
AzureTenant
Verbindungseigenschaft auf die ID des Microsoft Entra ID Tenants, wenn eine Verbindung mit dem Microsoft OneDrive Connector hergestellt wird. Andernfalls schlägt der Authentifizierungsversuch mit einem Fehler fehl. - Wenn Ihre Anwendung nur für den privaten Gebrauch bestimmt ist, geben Sie an
Accounts in this organization directory only
. - Wenn Sie Ihre Anwendung verteilen möchten, wählen Sie eine der Multi-Tenant-Optionen.
- Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie die
- Setzen Sie die Weiterleitungs URL auf
http://localhost:33333
(Standard des Connectors) ODER geben Sie einen anderen Port an und setzen SieCallbackURL
an die genaue Antwort-URL, die Sie definiert haben. - Klicken Sie auf
Register
, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
Notieren Sie den Wert inApplication (client) ID
alsOAuthClientId
und dasDirectory (tenant) ID
alsAzureTenant
. - Navigieren Sie zu
Certificates & Secrets
und definieren Sie den Authentifizierungstyp der Anwendung. Es stehen zwei Arten der Authentifizierung zur Verfügung: Zertifikat (empfohlen) oder Client-Geheimnis.- Für die Zertifikatauthentifizierung: In
Certificates & Secrets
, wählenUpload certificate
, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch. - Zum Erstellen eines neuen Client-Geheimnisses: In
Certificates & Secrets
, wählenNew Client Secret
für die Anwendung und geben Sie deren Dauer an. Nachdem das Clientgeheimnis gespeichert wurde, zeigt Microsoft OneDrive den Schlüsselwert an. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird. Dieser Wert wird zumOAuthClientSecret
.
- Für die Zertifikatauthentifizierung: In
- Auswählen
API Permissions > Add > Delegated permissions
. - Wählen Sie die Microsoft Graph API aus und fügen Sie dann die delegierten Berechtigungen Files.ReadWrite.All oder Files.Read.All hinzu. Klicken Sie anschließend auf die Schaltfläche „Administratorzustimmung erteilen“, damit die neuen Berechtigungen wirksam werden.
- Speichern Sie Ihre Änderungen.
- Wenn Sie die Verwendung von Berechtigungen angegeben haben, für die die Zustimmung des Administrators erforderlich ist, können Sie diese vom aktuellen Mandanten aus auf der Seite „API Berechtigungen“ erteilen.
Microsoft Entra-Dienstprinzipal
Um die Microsoft Entra-Dienstprinzipalauthentifizierung zu verwenden, müssen Sie die Möglichkeit einrichten, der Authentifizierungsanwendung eine Rolle zuzuweisen. Anschließend müssen Sie eine Anwendung beim Microsoft Entra ID Mandanten registrieren, um einen neuen Dienstprinzipal zu erstellen. Dieser neue Dienstprinzipal kann dann den zugewiesenen rollenbasierten Zugriff nutzen.
Kontrolle über den Zugriff auf Ressourcen in Ihrem Abonnement.
In portal.azure.com
:
- Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
- Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
- Öffnen Sie die
Subscriptions
Seite. - Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
- Öffnen Sie die
Access control (IAM)
. - Auswählen
Add > Add role assignment
. Microsoft OneDrive öffnet dasAdd role assignment
Seite. - Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu
Owner
.
Zustimmung des Administrators
Einige benutzerdefinierte Anwendungen erfordern Administratorberechtigungen, um innerhalb eines Microsoft Entra ID Mandanten ausgeführt zu werden. Die Administratorzustimmung kann beim Erstellen einer neuen benutzerdefinierten OAuth-Anwendung erteilt werden, indem relevante Berechtigungen hinzugefügt werden, die bereits mit „Administratorzustimmung erforderlich“ gekennzeichnet sind. Die Administratorzustimmung ist auch erforderlich, um Clientanmeldeinformationen im OAuth-Flow zu verwenden.
So erteilen Sie die Administratoreinwilligung:
- Lassen Sie einen Administrator sich anmelden bei
portal.azure.com
. - Navigieren Sie zu
App Registrations
und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben. - Unter
API Permissions
, klickGrant Consent
.
Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.
Optimieren des Datenzugriffs
Optimieren Sie den Datenzugriff
DirectoryRetrievalDepth
: Wie viele Ordner tief Sie Ergebnisse für die Tabellen „Ordner“, „Dateien“, „Freigegebene Ressourcen“ und „Berechtigungen“ erhalten möchten.DriveId
: Die ID des Laufwerks, das Sie zum Abrufen von Daten für die Tabellen „Dateien“, „Ordner“, „Freigegebene Ressourcen“ und „Berechtigungen“ verwenden möchten.ListGroupDrives
: Gibt an, ob Sie beim Abfragen der Laufwerkstabelle Ihre Gruppenlaufwerke auflisten möchten oder nicht. Nützlich, wenn Sie ein OneDrive for Business-Konto verwenden.
Wichtige Hinweise
Konfigurationsdateien und ihre Pfade
- Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.
Erweiterte Funktionen
In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Microsoft OneDrive-Connectors beschrieben.
Benutzerdefinierte Ansichten
Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.
SSL-Konfiguration
Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert
-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.
Proxy
So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings
Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.
Abfrageverarbeitung
Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf Microsoft OneDrive und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).
Benutzerdefinierte Ansichten
Mit dem Microsoft OneDrive Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.
Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:
- Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
- DDL-Anweisungen.
Definieren von Ansichten mithilfe einer Konfigurationsdatei
Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json
. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.
Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews
Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.
Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:
- Jedes Stammelement definiert den Namen einer Ansicht.
- Jedes Stammelement enthält ein untergeordnetes Element namens
query
, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.
Zum Beispiel:
{
"MyView": {
"query": "SELECT * FROM Files WHERE MyColumn = 'value'"
},
"MyView2": {
"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
}
}
Verwenden Sie UserDefinedViews
Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:
"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"
Definieren von Ansichten mit DDL-Anweisungen
Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.
Erstellen einer Ansicht
Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:
CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;
Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews
Verbindungseigenschaft.
Ändern einer Ansicht
Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:
ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';
Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.
Löschen einer Ansicht
Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.
DROP LOCAL VIEW [MyViewName]
Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.
Schema für benutzerdefinierte Ansichten
Benutzerdefinierte Ansichten werden im angezeigt UserViews
Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName
Eigentum.
Arbeiten mit benutzerdefinierten Ansichten
Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers
listet nur Kunden in Raleigh auf:
SELECT * FROM Customers WHERE City = 'Raleigh';
Ein Beispiel für eine Abfrage an den Treiber:
SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';
Daraus ergibt sich die effektive Abfrage an die Quelle:
SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';
Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.
SSL-Konfiguration
Anpassen der SSL-Konfiguration
Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.
Um ein anderes Zertifikat anzugeben, siehe SSLServerCert
Eigenschaft für die verfügbaren Formate, um dies zu tun.
Datenmodell
Der Connector modelliert die Microsoft OneDrive API als relationale Tabellen. Alle Änderungen an den Remotedaten werden sofort in Ihren Abfragen widergespiegelt; die Tabellendefinitionen werden dynamisch abgerufen. Wenn Sie eine Verbindung herstellen, stellt der Connector eine Verbindung zu Microsoft OneDrive her und ruft die Liste der Tabellen und die Metadaten für die Tabellen ab, indem er die entsprechenden Webdienste aufruft.
Hauptmerkmale
- Der Connector modelliert Microsoft OneDrive-Entitäten wie Dateien und Ordner als relationale Ansichten, sodass Sie SQL schreiben können, um Microsoft OneDrive Daten Abfrage.
- Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Microsoft OneDrive, einschließlich des Abrufens und Aktualisierens des Zugriffstokens in OAuth 2.0.
- Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Microsoft OneDrive Konto bei Verwendung des Connectors sofort angezeigt werden.
Ansichten
Ansichten zeigt Definitionen von einer Beispiel-OneDrive-Site. Das eigentliche Datenmodell
wird dynamisch basierend auf Ihren Benutzeranmeldeinformationen und Ihrer Site abgerufen.
Gespeicherte Prozeduren
Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu OneDrive. Sie können zum Suchen, Aktualisieren und Ändern von Informationen in OneDrive verwendet werden.
Ansichten
Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.
Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.
Microsoft OneDrive Connector-Ansichten
Name | Beschreibung |
---|---|
Drives | Die OneDrive-Ansicht „Laufwerke“, in der alle Laufwerke aufgelistet sind, auf die der Benutzer Zugriff hat. |
Files | Die OneDrive-Tabelle „Dateien“, in der Sie alle Dateien eines Laufwerks anzeigen können. |
FileVersions | Die OneDrive-Tabelle „Dateien“, in der Sie alle Dateien eines Laufwerks anzeigen können. |
Folders | Die OneDrive-Tabelle „Ordner“, die alle Ordner eines Laufwerks anzeigt. |
Permissions | Die OneDrive-Tabelle „Berechtigungen“, die alle Berechtigungen anzeigt, die einer Ressource des Laufwerks erteilt wurden. |
SharedResources | Die OneDrive-Tabelle SharedResources, die alle freigegebenen Ressourcen auf einem Laufwerk anzeigt. |
Users | Die OneDrive-Tabelle „Benutzer“, in der ein Administratorbenutzer die Benutzerdetails anzeigen kann. |
Laufwerke
Die OneDrive-Ansicht „Laufwerke“, in der alle Laufwerke aufgelistet sind, auf die der Benutzer Zugriff hat.
Tabellenspezifische Informationen
Aufgrund von API Einschränkungen werden alle Operatoren in dieser Ansicht clientseitig ausgeführt.
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
driveType | String | ||
owner_application_displayName | String | ||
owner_application_id | String | ||
quota_deleted | Long | ||
quota_remaining | Long | ||
quota_state | String | ||
quota_storagePlanInformation_upgradeAvailable | Bool | ||
quota_total | Long | ||
quota_used | Long | ||
sharePointIds_listId | String | ||
sharePointIds_listItemId | String | ||
sharePointIds_listItemUniqueId | String | ||
sharePointIds_siteId | String | ||
sharePointIds_siteUrl | String | ||
sharePointIds_tenantId | String | ||
sharePointIds_webId | String | ||
Linkedfollowing | String | ||
Linkeditems | String | ||
Linkedlist | String | ||
Linkedroot | String | ||
Linkedspecial | String | ||
ParentReference | String | ||
Id [KEY] | String | ||
Name | String | ||
Description | String | ||
owner_user_id | String |
Dateien
Die OneDrive-Tabelle „Dateien“, in der Sie alle Dateien eines Laufwerks anzeigen können.
Tabellenspezifische Informationen
Die Projektion erfolgt serverseitig. Auch Abfragen, die den Primärschlüssel ID und IN enthalten, werden serverseitig ausgeführt, z. B.:
SELECT Id, Name, audio_album, audio_title FROM Files WHERE ID IN ('B1E6BJ084A9133KB1!101', 'APF9D2K6WFA524Y')
Fügen Sie ParentReference_DriveId und ParentReference_Id in die Where-Klausel ein, um das Ergebnis für einen bestimmten Ordner zu erhalten, z. B.:
SELECT * FROM Files WHERE ParentReference_DriveId = 'b!3Yqza-5FJ0usfhyH-2QafkQpf0OC0jlNh8LAETWPK6dNROPDScevTKbV-drnCFHV' And ParentReference_id = '01QFG2V52Z62HOXS5F6RHIHVT36T3Q5GKH'
Die Dateiauflistung erfolgt rekursiv über DirectoryRetrievalDepth
-Eigenschaft. Der Standardwert dieser Eigenschaft ist 5, was bedeutet, dass nur Daten für die ersten 6 Ebenen des von Ihnen gewählten „Laufwerks“ abgerufen werden (da sich die erste Ebene in DirectoryRetrievalDepth=0 befindet).
Sie können den Wert -1 angeben, um alle Dateien im „Laufwerk“ abzurufen, unabhängig von der Tiefe, in der sie sich befinden.
Während Dateien in dieser Ansicht aufgelistet werden können, kann mit den Inhalten der Dateien mithilfe gespeicherter Prozeduren wie diesen gearbeitet werden:
- CopyResource - Kopieren Sie eine Datei/einen Ordner von einem Verzeichnis auf Ihrem Laufwerk in ein anderes.
- Ressource löschen - Löschen Sie eine Datei/einen Ordner von Ihrem Laufwerk.
- DownloadFile - Laden Sie eine vorhandene Datei von Ihrem Laufwerk herunter.
- MoveResource - Verschieben Sie eine Datei/einen Ordner von einem Verzeichnis auf Ihrem Laufwerk in ein anderes.
- UploadFile - Laden Sie eine neue Datei hoch oder aktualisieren Sie den Inhalt einer vorhandenen Datei.
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
id [KEY] | String | ||
Etag | String | ||
createdBy_user_id | String | ||
createdBy_user_displayName | String | ||
lastModifiedBy_user_id | String | ||
lastModifiedBy_user_displayName | String | ||
ResourceType | String | ||
createdBy_application_displayName | String | ||
createdBy_application_id | String | ||
createdDateTime | Datetime | ||
description | String | ||
lastModifiedBy_application_displayName | String | ||
lastModifiedBy_application_id | String | ||
lastModifiedDateTime | Datetime | ||
name | String | ||
parentReference_driveId | String | ||
parentReference_driveType | String | ||
parentReference_id | String | Ordner.Ich würde | |
parentReference_name | String | ||
parentReference_path | String | ||
parentReference_shareId | String | ||
parentReference_sharepointIds_listId | String | ||
parentReference_sharepointIds_listItemId | String | ||
parentReference_sharepointIds_listItemUniqueId | String | ||
parentReference_sharepointIds_siteId | String | ||
parentReference_sharepointIds_siteUrl | String | ||
parentReference_sharepointIds_tenantId | String | ||
parentReference_sharepointIds_webId | String | ||
parentReference_siteId | String | ||
webUrl | String | ||
LinkedcreatedByUser | String | ||
LinkedlastModifiedByUser | String | ||
audio_album | String | ||
audio_albumArtist | String | ||
audio_artist | String | ||
audio_bitrate | Long | ||
audio_composers | String | ||
audio_copyright | String | ||
audio_disc | Int | ||
audio_discCount | Int | ||
audio_duration | Long | ||
audio_genre | String | ||
audio_hasDrm | Bool | ||
audio_isVariableBitrate | Bool | ||
audio_title | String | ||
audio_track | Int | ||
audio_trackCount | Int | ||
audio_year | Int | ||
content | String | ||
cTag | String | ||
deleted_state | String | ||
file_hashes_crc32Hash | String | ||
file_hashes_quickXorHash | String | ||
file_hashes_sha1Hash | String | ||
file_hashes_sha256Hash | String | ||
file_mimeType | String | ||
file_processingMetadata | Bool | ||
fileSystemInfo_createdDateTime | Datetime | ||
fileSystemInfo_lastAccessedDateTime | Datetime | ||
fileSystemInfo_lastModifiedDateTime | Datetime | ||
folder_childCount | Int | ||
folder_view_sortBy | String | ||
folder_view_sortOrder | String | ||
folder_view_viewType | String | ||
image_height | Int | ||
image_width | Int | ||
location_altitude | Double | ||
location_latitude | Double | ||
location_longitude | Double | ||
package_type | String | ||
pendingOperations_pendingContentUpdate_queuedDateTime | Datetime | ||
photo_cameraMake | String | ||
photo_cameraModel | String | ||
photo_exposureDenominator | Double | ||
photo_exposureNumerator | Double | ||
photo_fNumber | Double | ||
photo_focalLength | Double | ||
photo_iso | Int | ||
photo_orientation | Int | ||
photo_takenDateTime | Datetime | ||
publication_level | String | ||
publication_versionId | String | ||
remoteItem_createdBy_application_displayName | String | ||
remoteItem_createdBy_application_id | String | ||
remoteItem_createdDateTime | Datetime | ||
remoteItem_file_hashes_crc32Hash | String | ||
remoteItem_file_hashes_quickXorHash | String | ||
remoteItem_file_hashes_sha1Hash | String | ||
remoteItem_file_hashes_sha256Hash | String | ||
remoteItem_file_mimeType | String | ||
remoteItem_file_processingMetadata | Bool | ||
remoteItem_fileSystemInfo_createdDateTime | Datetime | ||
remoteItem_fileSystemInfo_lastAccessedDateTime | Datetime | ||
remoteItem_fileSystemInfo_lastModifiedDateTime | Datetime | ||
remoteItem_folder_childCount | Int | ||
remoteItem_folder_view_sortBy | String | ||
remoteItem_folder_view_sortOrder | String | ||
remoteItem_folder_view_viewType | String | ||
remoteItem_id | String | ||
remoteItem_image_height | Int | ||
remoteItem_image_width | Int | ||
remoteItem_lastModifiedDateTime | Datetime | ||
remoteItem_name | String | ||
remoteItem_package_type | String | ||
remoteItem_parentReference_driveId | String | ||
remoteItem_parentReference_driveType | String | ||
remoteItem_parentReference_id | String | ||
remoteItem_parentReference_name | String | ||
remoteItem_parentReference_path | String | ||
remoteItem_parentReference_shareId | String | ||
remoteItem_parentReference_sharepointIds_listId | String | ||
remoteItem_parentReference_sharepointIds_listItemId | String | ||
remoteItem_parentReference_sharepointIds_listItemUniqueId | String | ||
remoteItem_parentReference_sharepointIds_siteId | String | ||
remoteItem_parentReference_sharepointIds_siteUrl | String | ||
remoteItem_parentReference_sharepointIds_tenantId | String | ||
remoteItem_parentReference_sharepointIds_webId | String | ||
remoteItem_parentReference_siteId | String | ||
remoteItem_shared_scope | String | ||
remoteItem_shared_sharedDateTime | Datetime | ||
remoteItem_size | Long | ||
remoteItem_specialFolder_name | String | ||
remoteItem_video_audioBitsPerSample | Int | ||
remoteItem_video_audioChannels | Int | ||
remoteItem_video_audioFormat | String | ||
remoteItem_video_audioSamplesPerSecond | Int | ||
remoteItem_video_bitrate | Int | ||
remoteItem_video_duration | Long | ||
remoteItem_video_fourCC | String | ||
remoteItem_video_frameRate | Double | ||
remoteItem_video_height | Int | ||
remoteItem_video_width | Int | ||
remoteItem_webDavUrl | String | ||
remoteItem_webUrl | String | ||
searchResult_onClickTelemetryUrl | String | ||
shared_owner_application_displayName | String | ||
shared_owner_application_id | String | ||
shared_scope | String | ||
shared_sharedDateTime | Datetime | ||
sharepointIds_listId | String | ||
sharepointIds_listItemId | String | ||
sharepointIds_listItemUniqueId | String | ||
sharepointIds_siteId | String | ||
sharepointIds_siteUrl | String | ||
sharepointIds_tenantId | String | ||
sharepointIds_webId | String | ||
size | Long | ||
specialFolder_name | String | ||
video_audioBitsPerSample | Int | ||
video_audioChannels | Int | ||
video_audioFormat | String | ||
video_audioSamplesPerSecond | Int | ||
video_bitrate | Int | ||
video_duration | Long | ||
video_fourCC | String | ||
video_frameRate | Double | ||
video_height | Int | ||
video_width | Int | ||
webDavUrl | String | ||
Linkedanalytics | String | ||
Linkedchildren | String | ||
LinkedlistItem | String | ||
Linkedpermissions | String | ||
Linkedsubscriptions | String | ||
Linkedthumbnails | String | ||
Linkedversions | String | ||
Linkedworkbook | String |
Dateiversionen
Die OneDrive-Tabelle „Dateien“, in der Sie alle Dateien eines Laufwerks anzeigen können.
Tabellenspezifische Informationen
WÄHLEN
Der Connector verwendet die Microsoft OneDrive API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.
FileId
unterstützt das '='.DriveId
unterstützt das '='.UserId
unterstützt das '='.
Beispiel:
SELECT * FROM FileVersions WHERE FileId = '01CYQN2MFPR6NIWVZNMNFL3SL4E3KF7IHY' AND DriveId = 'b!GrEGWax2VE-ssnJNr1E8llqoLptvK-BGjFRpceFzFg5Nwp9Bw2xbR62J0NAouP6z'
SELECT * FROM FileVersions WHERE FileId = '01CYQN2MFPR6NIWVZNMNFL3SL4E3KF7IHY' AND createdBy_user_id = '472df319-2978-49d4-9445-9e7019def16f'
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
FileId [KEY] | String | ||
lastModifiedBy_user_displayName | String | ||
lastModifiedBy_user_id | String | ||
lastModifiedDateTime | Datetime | ||
size | Long | ||
id | String | ||
lastModifiedBy_user_email | String | ||
DriveId | String | ||
publication_level | String | ||
createdBy_user_id | String |
Ordner
Die OneDrive-Tabelle „Ordner“, die alle Ordner auf einem Laufwerk anzeigt.
Tabellenspezifische Informationen
Hinweis: Siehe CreateFolder, um einen Ordner zu erstellen.
Die Projektion erfolgt serverseitig. Auch Abfragen, die den Primärschlüssel ID und IN enthalten, werden serverseitig ausgeführt, z. B.:
SELECT Id, Name, Size, Description FROM Folders WHERE ID IN ('B1E6BJ084A9133KB1!122', 'APF9D2K6WFAAPX9')
Die Ordnerauflistung erfolgt rekursiv über DirectoryRetrievalDepth
-Eigenschaft. Der Standardwert dieser Eigenschaft ist 5, was bedeutet, dass nur Daten für die ersten 6 Ebenen des von Ihnen gewählten „Laufwerks“ abgerufen werden (da sich die erste Ebene in DirectoryRetrievalDepth=0 befindet).
Sie können den Wert -1 angeben, um alle Ordner im „Laufwerk“ abzurufen, unabhängig von der Tiefe, in der sie sich befinden.
Während Ordner in dieser Ansicht aufgelistet werden können, kann mit den Inhalten der Ordner mithilfe gespeicherter Prozeduren wie diesen gearbeitet werden:
- CopyResource - Kopieren Sie eine Datei/einen Ordner von einem Verzeichnis auf Ihrem Laufwerk in ein anderes.
- Ressource löschen - Löschen Sie eine Datei/einen Ordner von Ihrem Laufwerk.
- MoveResource - Verschieben Sie eine Datei/einen Ordner von einem Verzeichnis auf Ihrem Laufwerk in ein anderes.
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
id [KEY] | String | ||
Etag | String | ||
createdBy_user_id | String | ||
createdBy_user_displayName | String | ||
lastModifiedBy_user_id | String | ||
lastModifiedBy_user_displayName | String | ||
createdBy_application_displayName | String | ||
createdBy_application_id | String | ||
createdDateTime | Datetime | ||
description | String | ||
lastModifiedBy_application_displayName | String | ||
lastModifiedBy_application_id | String | ||
lastModifiedDateTime | Datetime | ||
name | String | ||
parentReference_driveId | String | ||
parentReference_driveType | String | ||
parentReference_id | String | ||
parentReference_name | String | ||
parentReference_path | String | ||
parentReference_shareId | String | ||
parentReference_sharepointIds_listId | String | ||
parentReference_sharepointIds_listItemId | String | ||
parentReference_sharepointIds_listItemUniqueId | String | ||
parentReference_sharepointIds_siteId | String | ||
parentReference_sharepointIds_siteUrl | String | ||
parentReference_sharepointIds_tenantId | String | ||
parentReference_sharepointIds_webId | String | ||
parentReference_siteId | String | ||
webUrl | String | ||
LinkedcreatedByUser | String | ||
LinkedlastModifiedByUser | String | ||
audio_album | String | ||
audio_albumArtist | String | ||
audio_artist | String | ||
audio_bitrate | Long | ||
audio_composers | String | ||
audio_copyright | String | ||
audio_disc | Int | ||
audio_discCount | Int | ||
audio_duration | Long | ||
audio_genre | String | ||
audio_hasDrm | Bool | ||
audio_isVariableBitrate | Bool | ||
audio_title | String | ||
audio_track | Int | ||
audio_trackCount | Int | ||
audio_year | Int | ||
content | String | ||
cTag | String | ||
deleted_state | String | ||
file_hashes_crc32Hash | String | ||
file_hashes_quickXorHash | String | ||
file_hashes_sha1Hash | String | ||
file_hashes_sha256Hash | String | ||
file_mimeType | String | ||
file_processingMetadata | Bool | ||
fileSystemInfo_createdDateTime | Datetime | ||
fileSystemInfo_lastAccessedDateTime | Datetime | ||
fileSystemInfo_lastModifiedDateTime | Datetime | ||
folder_childCount | Int | ||
folder_view_sortBy | String | ||
folder_view_sortOrder | String | ||
folder_view_viewType | String | ||
image_height | Int | ||
image_width | Int | ||
location_altitude | Double | ||
location_latitude | Double | ||
location_longitude | Double | ||
package_type | String | ||
pendingOperations_pendingContentUpdate_queuedDateTime | Datetime | ||
photo_cameraMake | String | ||
photo_cameraModel | String | ||
photo_exposureDenominator | Double | ||
photo_exposureNumerator | Double | ||
photo_fNumber | Double | ||
photo_focalLength | Double | ||
photo_iso | Int | ||
photo_orientation | Int | ||
photo_takenDateTime | Datetime | ||
publication_level | String | ||
publication_versionId | String | ||
remoteItem_createdBy_application_displayName | String | ||
remoteItem_createdBy_application_id | String | ||
remoteItem_createdDateTime | Datetime | ||
remoteItem_file_hashes_crc32Hash | String | ||
remoteItem_file_hashes_quickXorHash | String | ||
remoteItem_file_hashes_sha1Hash | String | ||
remoteItem_file_hashes_sha256Hash | String | ||
remoteItem_file_mimeType | String | ||
remoteItem_file_processingMetadata | Bool | ||
remoteItem_fileSystemInfo_createdDateTime | Datetime | ||
remoteItem_fileSystemInfo_lastAccessedDateTime | Datetime | ||
remoteItem_fileSystemInfo_lastModifiedDateTime | Datetime | ||
remoteItem_folder_childCount | Int | ||
remoteItem_folder_view_sortBy | String | ||
remoteItem_folder_view_sortOrder | String | ||
remoteItem_folder_view_viewType | String | ||
remoteItem_id | String | ||
remoteItem_image_height | Int | ||
remoteItem_image_width | Int | ||
remoteItem_lastModifiedDateTime | Datetime | ||
remoteItem_name | String | ||
remoteItem_package_type | String | ||
remoteItem_parentReference_driveId | String | ||
remoteItem_parentReference_driveType | String | ||
remoteItem_parentReference_id | String | ||
remoteItem_parentReference_name | String | ||
remoteItem_parentReference_path | String | ||
remoteItem_parentReference_shareId | String | ||
remoteItem_parentReference_sharepointIds_listId | String | ||
remoteItem_parentReference_sharepointIds_listItemId | String | ||
remoteItem_parentReference_sharepointIds_listItemUniqueId | String | ||
remoteItem_parentReference_sharepointIds_siteId | String | ||
remoteItem_parentReference_sharepointIds_siteUrl | String | ||
remoteItem_parentReference_sharepointIds_tenantId | String | ||
remoteItem_parentReference_sharepointIds_webId | String | ||
remoteItem_parentReference_siteId | String | ||
remoteItem_shared_scope | String | ||
remoteItem_shared_sharedDateTime | Datetime | ||
remoteItem_size | Long | ||
remoteItem_specialFolder_name | String | ||
remoteItem_video_audioBitsPerSample | Int | ||
remoteItem_video_audioChannels | Int | ||
remoteItem_video_audioFormat | String | ||
remoteItem_video_audioSamplesPerSecond | Int | ||
remoteItem_video_bitrate | Int | ||
remoteItem_video_duration | Long | ||
remoteItem_video_fourCC | String | ||
remoteItem_video_frameRate | Double | ||
remoteItem_video_height | Int | ||
remoteItem_video_width | Int | ||
remoteItem_webDavUrl | String | ||
remoteItem_webUrl | String | ||
searchResult_onClickTelemetryUrl | String | ||
shared_owner_application_displayName | String | ||
shared_owner_application_id | String | ||
shared_scope | String | ||
shared_sharedDateTime | Datetime | ||
sharepointIds_listId | String | ||
sharepointIds_listItemId | String | ||
sharepointIds_listItemUniqueId | String | ||
sharepointIds_siteId | String | ||
sharepointIds_siteUrl | String | ||
sharepointIds_tenantId | String | ||
sharepointIds_webId | String | ||
size | Long | ||
specialFolder_name | String | ||
video_audioBitsPerSample | Int | ||
video_audioChannels | Int | ||
video_audioFormat | String | ||
video_audioSamplesPerSecond | Int | ||
video_bitrate | Int | ||
video_duration | Long | ||
video_fourCC | String | ||
video_frameRate | Double | ||
video_height | Int | ||
video_width | Int | ||
webDavUrl | String | ||
Linkedanalytics | String | ||
Linkedchildren | String | ||
LinkedlistItem | String | ||
Linkedpermissions | String | ||
Linkedsubscriptions | String | ||
Linkedthumbnails | String | ||
Linkedversions | String | ||
Linkedworkbook | String |
Berechtigungen
Die OneDrive-Tabelle „Berechtigungen“, die alle Berechtigungen anzeigt, die einer Ressource des Laufwerks erteilt wurden.
Tabellenspezifische Informationen
Aufgrund von API Einschränkungen werden alle Operatoren in dieser Ansicht clientseitig ausgeführt.
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
id [KEY] | String | ||
Etag | String | ||
ResourceId [KEY] | String | ||
grantedTo_user_displayName | String | ||
grantedTo_user_email | String | ||
grantedTo_user_id | String | ||
expirationDateTime | Datetime | ||
grantedTo_application_displayName | String | ||
grantedTo_application_id | String | ||
grantedToIdentities | String | ||
hasPassword | Bool | ||
inheritedFrom_driveId | String | ||
inheritedFrom_driveType | String | ||
inheritedFrom_id | String | ||
inheritedFrom_name | String | ||
inheritedFrom_path | String | ||
inheritedFrom_shareId | String | ||
inheritedFrom_sharepointIds_listId | String | ||
inheritedFrom_sharepointIds_listItemId | String | ||
inheritedFrom_sharepointIds_listItemUniqueId | String | ||
inheritedFrom_sharepointIds_siteId | String | ||
inheritedFrom_sharepointIds_siteUrl | String | ||
inheritedFrom_sharepointIds_tenantId | String | ||
inheritedFrom_sharepointIds_webId | String | ||
inheritedFrom_siteId | String | ||
invitation_email | String | ||
invitation_invitedBy_application_displayName | String | ||
invitation_invitedBy_application_id | String | ||
invitation_redeemedBy | String | ||
invitation_signInRequired | Bool | ||
link_application_displayName | String | ||
link_application_id | String | ||
link_preventsDownload | Bool | ||
link_scope | String | ||
link_type | String | ||
link_webHtml | String | ||
link_webUrl | String | ||
roles | String | ||
shareId | String |
Gemeinsam genutzte Ressourcen
Die OneDrive-Tabelle SharedResources, die alle freigegebenen Ressourcen auf einem Laufwerk anzeigt.
Tabellenspezifische Informationen
Die Projektion erfolgt serverseitig. Auch Abfragen, die den Primärschlüssel ID und IN enthalten, werden serverseitig ausgeführt, z. B.:
SELECT Id, Name, Size, Shared_Scope FROM SharedResources WHERE ID IN ('B1E6BJ084A9133KB1!122', 'APF9D2K6WFAAPX9')
Die Auflistung der SharedResources erfolgt rekursiv über DirectoryRetrievalDepth
-Eigenschaft. Der Standardwert dieser Eigenschaft ist 5, was bedeutet, dass nur Daten für die ersten 6 Ebenen des von Ihnen gewählten „Laufwerks“ abgerufen werden (da sich die erste Ebene in DirectoryRetrievalDepth=0 befindet).
Sie können den Wert -1 angeben, um alle freigegebenen Ressourcen im „Laufwerk“ abzurufen, unabhängig davon, in welcher Tiefe sie sich befinden.
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
id [KEY] | String | ||
Etag | String | ||
createdBy_user_id | String | ||
createdBy_user_displayName | String | ||
lastModifiedBy_user_id | String | ||
lastModifiedBy_user_displayName | String | ||
createdBy_application_displayName | String | ||
createdBy_application_id | String | ||
createdDateTime | Datetime | ||
description | String | ||
lastModifiedBy_application_displayName | String | ||
lastModifiedBy_application_id | String | ||
lastModifiedDateTime | Datetime | ||
name | String | ||
parentReference_driveId | String | ||
parentReference_driveType | String | ||
parentReference_id | String | ||
parentReference_name | String | ||
parentReference_path | String | ||
parentReference_shareId | String | ||
parentReference_sharepointIds_listId | String | ||
parentReference_sharepointIds_listItemId | String | ||
parentReference_sharepointIds_listItemUniqueId | String | ||
parentReference_sharepointIds_siteId | String | ||
parentReference_sharepointIds_siteUrl | String | ||
parentReference_sharepointIds_tenantId | String | ||
parentReference_sharepointIds_webId | String | ||
parentReference_siteId | String | ||
webUrl | String | ||
LinkedcreatedByUser | String | ||
LinkedlastModifiedByUser | String | ||
audio_album | String | ||
audio_albumArtist | String | ||
audio_artist | String | ||
audio_bitrate | Long | ||
audio_composers | String | ||
audio_copyright | String | ||
audio_disc | Int | ||
audio_discCount | Int | ||
audio_duration | Long | ||
audio_genre | String | ||
audio_hasDrm | Bool | ||
audio_isVariableBitrate | Bool | ||
audio_title | String | ||
audio_track | Int | ||
audio_trackCount | Int | ||
audio_year | Int | ||
content | String | ||
cTag | String | ||
deleted_state | String | ||
file_hashes_crc32Hash | String | ||
file_hashes_quickXorHash | String | ||
file_hashes_sha1Hash | String | ||
file_hashes_sha256Hash | String | ||
file_mimeType | String | ||
file_processingMetadata | Bool | ||
fileSystemInfo_createdDateTime | Datetime | ||
fileSystemInfo_lastAccessedDateTime | Datetime | ||
fileSystemInfo_lastModifiedDateTime | Datetime | ||
folder_childCount | Int | ||
folder_view_sortBy | String | ||
folder_view_sortOrder | String | ||
folder_view_viewType | String | ||
image_height | Int | ||
image_width | Int | ||
location_altitude | Double | ||
location_latitude | Double | ||
location_longitude | Double | ||
package_type | String | ||
pendingOperations_pendingContentUpdate_queuedDateTime | Datetime | ||
photo_cameraMake | String | ||
photo_cameraModel | String | ||
photo_exposureDenominator | Double | ||
photo_exposureNumerator | Double | ||
photo_fNumber | Double | ||
photo_focalLength | Double | ||
photo_iso | Int | ||
photo_orientation | Int | ||
photo_takenDateTime | Datetime | ||
publication_level | String | ||
publication_versionId | String | ||
remoteItem_createdBy_application_displayName | String | ||
remoteItem_createdBy_application_id | String | ||
remoteItem_createdDateTime | Datetime | ||
remoteItem_file_hashes_crc32Hash | String | ||
remoteItem_file_hashes_quickXorHash | String | ||
remoteItem_file_hashes_sha1Hash | String | ||
remoteItem_file_hashes_sha256Hash | String | ||
remoteItem_file_mimeType | String | ||
remoteItem_file_processingMetadata | Bool | ||
remoteItem_fileSystemInfo_createdDateTime | Datetime | ||
remoteItem_fileSystemInfo_lastAccessedDateTime | Datetime | ||
remoteItem_fileSystemInfo_lastModifiedDateTime | Datetime | ||
remoteItem_folder_childCount | Int | ||
remoteItem_folder_view_sortBy | String | ||
remoteItem_folder_view_sortOrder | String | ||
remoteItem_folder_view_viewType | String | ||
remoteItem_id | String | ||
remoteItem_image_height | Int | ||
remoteItem_image_width | Int | ||
remoteItem_lastModifiedDateTime | Datetime | ||
remoteItem_name | String | ||
remoteItem_package_type | String | ||
remoteItem_parentReference_driveId | String | ||
remoteItem_parentReference_driveType | String | ||
remoteItem_parentReference_id | String | ||
remoteItem_parentReference_name | String | ||
remoteItem_parentReference_path | String | ||
remoteItem_parentReference_shareId | String | ||
remoteItem_parentReference_sharepointIds_listId | String | ||
remoteItem_parentReference_sharepointIds_listItemId | String | ||
remoteItem_parentReference_sharepointIds_listItemUniqueId | String | ||
remoteItem_parentReference_sharepointIds_siteId | String | ||
remoteItem_parentReference_sharepointIds_siteUrl | String | ||
remoteItem_parentReference_sharepointIds_tenantId | String | ||
remoteItem_parentReference_sharepointIds_webId | String | ||
remoteItem_parentReference_siteId | String | ||
remoteItem_shared_scope | String | ||
remoteItem_shared_sharedDateTime | Datetime | ||
remoteItem_size | Long | ||
remoteItem_specialFolder_name | String | ||
remoteItem_video_audioBitsPerSample | Int | ||
remoteItem_video_audioChannels | Int | ||
remoteItem_video_audioFormat | String | ||
remoteItem_video_audioSamplesPerSecond | Int | ||
remoteItem_video_bitrate | Int | ||
remoteItem_video_duration | Long | ||
remoteItem_video_fourCC | String | ||
remoteItem_video_frameRate | Double | ||
remoteItem_video_height | Int | ||
remoteItem_video_width | Int | ||
remoteItem_webDavUrl | String | ||
remoteItem_webUrl | String | ||
searchResult_onClickTelemetryUrl | String | ||
shared_owner_application_displayName | String | ||
shared_owner_application_id | String | ||
shared_scope | String | ||
shared_sharedDateTime | Datetime | ||
sharepointIds_listId | String | ||
sharepointIds_listItemId | String | ||
sharepointIds_listItemUniqueId | String | ||
sharepointIds_siteId | String | ||
sharepointIds_siteUrl | String | ||
sharepointIds_tenantId | String | ||
sharepointIds_webId | String | ||
size | Long | ||
specialFolder_name | String | ||
video_audioBitsPerSample | Int | ||
video_audioChannels | Int | ||
video_audioFormat | String | ||
video_audioSamplesPerSecond | Int | ||
video_bitrate | Int | ||
video_duration | Long | ||
video_fourCC | String | ||
video_frameRate | Double | ||
video_height | Int | ||
video_width | Int | ||
webDavUrl | String | ||
Linkedanalytics | String | ||
Linkedchildren | String | ||
LinkedlistItem | String | ||
Linkedpermissions | String | ||
Linkedsubscriptions | String | ||
Linkedthumbnails | String | ||
Linkedversions | String | ||
Linkedworkbook | String |
Benutzer
Die OneDrive-Tabelle „Benutzer“, in der ein Administratorbenutzer die Benutzerdetails anzeigen kann.
Benutzerinformationen
Die Projektion erfolgt serverseitig. Einfache Abfrage werden unterstützt, z. B.:
SELECT * FROM Users
Mit dieser Ansicht kann ein Administratorbenutzer alle anderen Benutzerdetails auflisten.
Spalten
Name | Typ | Referenzen | Beschreibung |
---|---|---|---|
id [KEY] | String | ||
deletedDateTime | Datetime | ||
accountEnabled | Bool | ||
businessPhones | String | ||
city | String | ||
companyName | String | ||
country | String | ||
createdDateTime | Datetime | ||
department | String | ||
displayName | String | ||
employeeHireDate | Datetime | ||
employeeId | String | ||
employeeOrgData_costCenter | String | ||
employeeOrgData_division | String | ||
employeeType | String | ||
givenName | String | ||
identities | String | ||
imAddresses | String | ||
isResourceAccount | Bool | ||
jobTitle | String | ||
lastPasswordChangeDateTime | Datetime | ||
mail | String | ||
mailNickname | String | ||
mobilePhone | String | ||
officeLocation | String | ||
onPremisesDistinguishedName | String | ||
onPremisesDomainName | String | ||
onPremisesExtensionAttributes_extensionAttribute1 | String | ||
onPremisesExtensionAttributes_extensionAttribute10 | String | ||
onPremisesExtensionAttributes_extensionAttribute11 | String | ||
onPremisesExtensionAttributes_extensionAttribute12 | String | ||
onPremisesExtensionAttributes_extensionAttribute13 | String | ||
onPremisesExtensionAttributes_extensionAttribute14 | String | ||
onPremisesExtensionAttributes_extensionAttribute15 | String | ||
onPremisesExtensionAttributes_extensionAttribute2 | String | ||
onPremisesExtensionAttributes_extensionAttribute3 | String | ||
onPremisesExtensionAttributes_extensionAttribute4 | String | ||
onPremisesExtensionAttributes_extensionAttribute5 | String | ||
onPremisesExtensionAttributes_extensionAttribute6 | String | ||
onPremisesExtensionAttributes_extensionAttribute7 | String | ||
onPremisesExtensionAttributes_extensionAttribute8 | String | ||
onPremisesExtensionAttributes_extensionAttribute9 | String | ||
onPremisesImmutableId | String | ||
onPremisesLastSyncDateTime | Datetime | ||
onPremisesProvisioningErrors | String | ||
onPremisesSamAccountName | String | ||
onPremisesSecurityIdentifier | String | ||
onPremisesSyncEnabled | Bool | ||
onPremisesUserPrincipalName | String | ||
otherMails | String | ||
postalCode | String | ||
preferredLanguage | String | ||
state | String | ||
streetAddress | String | ||
surname | String | ||
userPrincipalName | String | ||
userType | String |
Gespeicherte Prozeduren
Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT-Operationen mit Microsoft OneDrive hinaus erweitern.
Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Microsoft OneDrive zurück, zusammen mit einem Hinweis, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.
Gespeicherte Prozeduren für den Microsoft OneDrive Connector
Name | Beschreibung |
---|---|
CopyResource | Kopieren Sie eine Ressource von einem Verzeichnis auf Ihrem Laufwerk in ein anderes. |
CreateFolder | Erstellen Sie einen neuen Ordner in Ihrem Laufwerk. |
CreateSubscription | Abonniert eine Listener-Anwendung, um Benachrichtigungen bei Datenänderungen zu erhalten. |
DeleteResource | Löschen Sie eine Ressource von Ihrem Laufwerk. |
DeleteSubscription | Abonniert eine Listener-Anwendung, um Benachrichtigungen bei Datenänderungen zu erhalten. |
DownloadFile | Laden Sie eine vorhandene Datei von Ihrem Laufwerk herunter. |
FetchAdditionalUserFields | Ruft alle T1-, T2- und T3-Felder für einen angegebenen Benutzer ab. |
GetAdminConsentURL | Ruft die Administratoreinwilligungs URL ab, die von einem Administrator einer bestimmten Domäne separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Nur erforderlich, wenn benutzerdefinierte OAuth-Anmeldeinformationen verwendet werden. |
GetOAuthAccessToken | Ruft ein Authentifizierungstoken von OneDrive ab. |
GetOAuthAuthorizationURL | Ruft die Autorisierungs-URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern das Authentifizierungstoken von dieser URL an. |
ModifySubscription | Abonniert eine Listener-Anwendung, um Benachrichtigungen bei Datenänderungen zu erhalten. |
MoveResource | Verschieben Sie eine Ressource von einem Verzeichnis in Ihrem Laufwerk in ein anderes. |
RefreshOAuthAccessToken | Aktualisiert das OAuth-Zugriffstoken, das für die Authentifizierung bei verschiedenen Office 365-Diensten verwendet wird. |
RenameResource | Benennen Sie Dateien von Ihrem Laufwerk um. |
UploadFile | Laden Sie eine neue Datei hoch oder aktualisieren Sie den Inhalt einer vorhandenen Datei. |
Ressource kopieren
Kopieren Sie eine Ressource von einem Verzeichnis auf Ihrem Laufwerk in ein anderes.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
ParentID | String | True | Die ID des Ordners, in den Sie die Ressource kopieren möchten. |
NewName | String | Falsch | Der neue Name der kopierten Ressource. Wenn nicht angegeben, wird die Ressource mit demselben Namen, den sie bereits hat, und in das Verzeichnis, in dem sie sich aktuell befindet, kopiert, unabhängig vom Wert von ParentID. |
ResourcePath | String | Falsch | Der Standort der Ressource. |
ResourceId | String | Falsch | ID der Ressource. |
SourceDriveId | String | Falsch | Die ID des Laufwerks, auf dem sich die Ressource befindet, sofern dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
DestinationDriveId | String | Falsch | Die ID des Laufwerks, auf das die Ressource kopiert werden soll, sofern diese sich von der SourceDriveId unterscheidet. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Ergebnisse der Dateikopie. |
Ordner erstellen
Erstellen Sie einen neuen Ordner in Ihrem Laufwerk.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
FolderName | String | True | Name des zu erstellenden Ordners. |
RenameIfExists | String | Falsch | Setzen Sie dies auf „true“, wenn Sie den Ordner umbenennen möchten und ein anderer Ordner mit demselben Namen vorhanden ist. |
ParentId | String | Falsch | ID des Ordners, in dem der neue Ordner erstellt werden soll. |
DriveId | String | Falsch | Die ID des Laufwerks, auf dem sich die Ressource befindet, sofern dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Id | String | ID des erstellten Ordners. |
Abonnement erstellen
Abonniert eine Listener-Anwendung, um Benachrichtigungen zu erhalten, wenn sich Daten ändern.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
ChangeType | String | True | Gibt den Änderungstyp in der abonnierten Ressource an, der eine Änderungsbenachrichtigung auslöst. Die unterstützten Werte sind: erstellt, aktualisiert, gelöscht. Mehrere Werte können mithilfe einer durch Kommas getrennten Liste kombiniert werden. |
NotificationUrl | String | True | Die URL des Endpoint, der die Änderungsbenachrichtigungen erhält. Diese URL muss das HTTPS-Protokoll verwenden. |
Resource | String | True | Gibt die Ressource an, die auf Änderungen überwacht wird. Schließen Sie die Basis URL (https://graph.microsoft.com/v1.0/ ) nicht ein. |
ExpirationDateTime | String | Falsch | Datum und Uhrzeit in UTC, an denen das Abonnement abläuft. Informationen zur maximalen Dauer jedes Endpoint finden Sie in der Microsoft-Dokumentation https://docs.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0. |
ClientState | String | Falsch | Gibt den Wert der Eigenschaft clientState an, die vom Dienst in jeder Änderungsbenachrichtigung gesendet wird. Die maximale Länge beträgt 128 Zeichen. Der Client kann überprüfen, ob die Änderungsbenachrichtigung vom Dienst kam, indem er den Wert der Eigenschaft clientState, die mit dem Abonnement gesendet wurde, mit dem Wert der Eigenschaft clientState vergleicht, die mit jeder Änderungsbenachrichtigung empfangen wurde. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Id | String | ID des erstellten Abonnements. |
Ressource löschen
Löschen Sie eine Ressource von Ihrem Laufwerk.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
ResourcePath | String | Falsch | Der Standort der Ressource. |
ResourceId | String | Falsch | ID der Ressource. |
DriveId | String | Falsch | Die ID des Laufwerks, auf dem sich die Ressource befindet, sofern dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Ergebnisse des Dateilöschens. |
Abonnement löschen
Abonniert eine Listener-Anwendung, um Benachrichtigungen zu erhalten, wenn sich Daten ändern.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
Id | String | True | ID des erstellten Abonnements. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Ergebnisse der Abonnementlöschung. |
Datei herunterladen
Laden Sie eine vorhandene Datei von Ihrem Laufwerk herunter.
Eingang
Name | Typ | Erforderlich | Akzeptiert Ausgabestreams | Beschreibung |
---|---|---|---|---|
ResourcePath | String | Falsch | Falsch | Der Standort der Ressource. |
ResourceId | String | Falsch | Falsch | Die ID der herunterzuladenden Ressource. |
DriveId | String | Falsch | Falsch | Die ID des Laufwerks, auf dem sich die Ressource befindet, sofern dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
LocalFile | String | Falsch | Falsch | Der lokale Dateipfad einschließlich des Dateinamens für den Speicherort, an dem die Datei auf der Festplatte gespeichert wird. Leer lassen, um die Datei im Speicher zu behalten. |
Encoding | String | Falsch | Falsch | Wenn der LocalFile-Eingang leer gelassen wird, werden die Daten in der angegebenen Kodierung in FileData ausgegeben. Die zulässigen Werte sind NONE, BASE64. Der Standardwert ist BASE64. |
Overwrite | String | Falsch | Falsch | Was tun, wenn die heruntergeladene Datei vorhanden ist? Zum Überschreiben auf „True“ setzen. |
FileStream | String | Falsch | Wahr | Eine Instanz eines Ausgabestreams, in den Dateidaten geschrieben werden. Wird nur verwendet, wenn DownloadPath nicht angegeben ist. |
Version | String | Falsch | Falsch | Geben Sie die Version der Datei an, mit Ausnahme der neuesten. |
UserId | String | Falsch | Falsch | Die ID des Benutzers, der die Datei erstellt hat. Nur erwähnen, wenn die Version angegeben ist |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
FileData | String | Wenn die Eingabe „LocalFile“ leer ist, werden die Dateidaten in dem durch die Eingabe „Encoding“ angegebenen Format ausgegeben. |
Success | String | Ergebnisse des Dateidownloads. |
Zusätzliche Benutzerfelder abrufen
Alle T1-, T2- und T3-Felder für einen angegebenen Benutzer abrufen.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
UserId | String | True | Die eindeutige Kennung des Benutzers. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
\* | String | Ergebnisse der Abfrage: alle Felder des Benutzerobjekts. |
GetAdminConsentURL
Ruft die Administratoreinwilligungs URL ab, die von einem Administrator einer bestimmten Domäne separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Nur erforderlich, wenn benutzerdefinierte OAuth-Anmeldeinformationen verwendet werden.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
CallbackUrl | String | Falsch | Die URL, zu der der Benutzer nach der Autorisierung Ihrer Anwendung weitergeleitet wird. Dieser Wert muss mit der Antwort-URL in den App-Einstellungen von Microsoft Entra ID übereinstimmen. |
State | String | Falsch | Derselbe Statuswert, den Sie gesendet haben, als Sie den Autorisierungscode angefordert haben. |
Scope | String | Falsch | Eine durch Leerzeichen getrennte Liste von Bereichen, die vom Administrator angefordert werden sollen. Der Standardwert ist https://graph.microsoft.com/files.readwrite.all. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
URL | String | Die Autorisierungs-URL, die in einen Webbrowser eingegeben wird, um das Prüftoken zu erhalten und Ihre App zu autorisieren. |
GetOAuthAccessToken
Ruft ein Authentifizierungstoken von OneDrive ab.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
AuthMode | String | Falsch | Der zu verwendende Authentifizierungsmodustyp. Wählen Sie „App“, um Authentifizierungstoken über eine Desktop-App abzurufen. Wählen Sie „Web“, um Authentifizierungstoken über eine Web-App abzurufen. Die zulässigen Werte sind APP, WEB. Der Standardwert ist APP. |
CallbackUrl | String | Falsch | Die URL, zu der der Benutzer nach der Autorisierung Ihrer Anwendung weitergeleitet wird. Dieser Wert muss mit der Antwort URL übereinstimmen, die Sie in den Einstellungen der Microsoft Entra ID -App angegeben haben. |
Verifier | String | Falsch | Der von Microsoft Entra ID zurückgegebene Prüfer, nachdem der Benutzer Ihrer App den Zugriff auf seine Daten autorisiert hat. Dieser Wert wird als Parameter an die Rückruf-URL zurückgegeben. |
Scope | String | Falsch | Eine durch Leerzeichen getrennte Liste von Bereichen, die vom Benutzer angefordert werden sollen, wenn OAuthGrantType='CODE'. Wenn OAuthGrantType='CLIENT', wird ein Bereich von 'https://graph.microsoft.com/.default' verwendet. '/.default' übernimmt alle Berechtigungen, die Ihre App bereits hat. Der Standardwert ist offline_access https://graph.microsoft.com/files.readwrite.all. |
State | String | Falsch | Eine beliebige Zeichenfolge Ihrer Wahl, die an Ihre App zurückgegeben wird. Ein erfolgreicher Roundtrip dieser Zeichenfolge trägt dazu bei sicherzustellen, dass Ihre App die Anforderung initiiert hat. |
Prompt | String | Falsch | Standardmäßig ist „select_account“ eingestellt, wodurch der Benutzer bei der Authentifizierung aufgefordert wird, ein Konto auszuwählen. Auf „None“ eingestellt, um keine Eingabeaufforderung zu erhalten, auf „login“, um den Benutzer zur Eingabe seiner Anmeldeinformationen zu zwingen, oder auf „consent“, um nach der Anmeldung des Benutzers den OAuth-Zustimmungsdialog auszulösen, in dem der Benutzer aufgefordert wird, der App Berechtigungen zu erteilen. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
OAuthAccessToken | String | Das für die Kommunikation mit OneDrive verwendete Zugriffstoken. |
ExpiresIn | String | Die verbleibende Lebensdauer des Zugriffstokens. Eine -1 bedeutet, dass es nicht abläuft. |
OAuthRefreshToken | String | Aktualisierungstoken zum Erneuern des Zugriffstokens. |
GetOAuthAuthorizationURL
Ruft die Autorisierungs URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern das Authentifizierungstoken von dieser URL an.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
CallbackUrl | String | Falsch | Die URL, zu der der Benutzer nach der Autorisierung Ihrer Anwendung weitergeleitet wird. Dieser Wert muss mit der Antwort-URL in den App-Einstellungen von Microsoft Entra ID übereinstimmen. |
State | String | Falsch | Derselbe Statuswert, den Sie gesendet haben, als Sie den Autorisierungscode angefordert haben. |
Scope | String | Falsch | Eine durch Leerzeichen getrennte Liste von Bereichen, die vom Benutzer angefordert werden sollen, wenn OAuthGrantType='CODE'. Wenn OAuthGrantType='CLIENT', wird ein Bereich von 'https://graph.microsoft.com/.default' verwendet. '/.default' übernimmt alle Berechtigungen, die Ihre App bereits hat. Der Standardwert ist offline_access https://graph.microsoft.com/files.readwrite.all. |
Prompt | String | Falsch | Standardmäßig ist „select_account“ eingestellt, wodurch der Benutzer bei der Authentifizierung aufgefordert wird, ein Konto auszuwählen. Auf „None“ eingestellt, um keine Eingabeaufforderung zu erhalten, auf „login“, um den Benutzer zur Eingabe seiner Anmeldeinformationen zu zwingen, oder auf „consent“, um nach der Anmeldung des Benutzers den OAuth-Zustimmungsdialog auszulösen, in dem der Benutzer aufgefordert wird, der App Berechtigungen zu erteilen. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
URL | String | Die Autorisierungs-URL, die in einen Webbrowser eingegeben wird, um das Prüftoken zu erhalten und Ihre App zu autorisieren. |
Abonnement ändern
Abonniert eine Listener-Anwendung, um Benachrichtigungen zu erhalten, wenn sich Daten ändern.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
ExpirationDateTime | String | True | Datum und Uhrzeit in UTC, an dem das Abonnement abläuft. |
Id | String | True | ID des erstellten Abonnements. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Id | String | ID des erstellten Abonnements. |
ChangeType | String | Name des zu erstellenden Ordners. |
NotificationUrl | String | Der Webhook-Endpoint, den Sie abonnieren möchten. |
Resource | String | Der Pfad der Ressource für die Abonnementdetails. |
ExpirationDateTime | String | Datum und Uhrzeit in UTC, an dem das Abonnement abläuft. |
ClientState | String | Codierte Zeichenfolge, die die Anzeige- und Steuerungsstatusdaten der Webseite enthält |
Ressource verschieben
Verschieben Sie eine Ressource von einem Verzeichnis in Ihrem Laufwerk in ein anderes.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
DestinationID | String | True | Die ID des Ordners, in den Sie die Ressource verschieben möchten. |
ResourcePath | String | Falsch | Der Standort der Ressource. |
ResourceId | String | Falsch | ID der Ressource. |
DriveId | String | Falsch | Die ID des Laufwerks, auf dem sich die Ressource befindet, sofern dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Ergebnisse der Dateiverschiebung. |
Aktualisieren Sie das OAuthAccessToken
Aktualisiert das OAuth-Zugriffstoken, das für die Authentifizierung bei verschiedenen Office 365-Diensten verwendet wird.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
OAuthRefreshToken | String | True | Das vom ursprünglichen Autorisierungscode-Austausch zurückgegebene Aktualisierungstoken. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
OAuthAccessToken | String | Das von Microsoft Entra ID zurückgegebene Authentifizierungstoken. Dieses kann in nachfolgenden Aufrufen anderer Vorgänge für diesen bestimmten Dienst verwendet werden. |
OAuthRefreshToken | String | Ein Token, der zum Abrufen eines neuen Zugriffstokens verwendet werden kann. |
ExpiresIn | String | Die verbleibende Lebensdauer des Zugriffstokens. |
Ressource umbenennen
Benennen Sie Dateien von Ihrem Laufwerk um.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
ResourceId | String | True | ID der Ressource. |
Name | String | True | Der neue Name der Ressource. |
DriveId | String | Falsch | Die ID des Laufwerks, auf dem sich die Ressource befindet, sofern dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Ergebnisse der Dateiumbenennung. |
Datei hochladen
Laden Sie eine neue Datei hoch oder aktualisieren Sie den Inhalt einer vorhandenen Datei.
Eingang
Name | Typ | Erforderlich | Akzeptiert Eingabeströme | Beschreibung |
---|---|---|---|---|
ParentId | String | True | False | Zu welchem übergeordneten Element die Datei hochgeladen werden soll. |
DriveId | String | Falsch | Falsch | Die ID des Laufwerks, auf das die Datei hochgeladen werden soll, wenn dieses sich vom aktuellen Benutzerlaufwerk unterscheidet. |
FileName | String | Wahr | Falsch | Name der Datei, in die Sie Inhalte hochladen. |
Content | String | Falsch | Falsch | Hochzuladender Dateiinhalt. |
LocalFile | String | Falsch | Falsch | Lokale Datei, die den hochzuladenden Inhalt enthält. |
ContentStream | String | Falsch | Wahr | Hochzuladender Dateiinhalt. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Ergebnisse des Datei-Uploads. |
Systemtabellen
Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.
Schematabellen
Die folgenden Tabellen geben Datenbankmetadaten für Microsoft OneDrive zurück:
- sys_catalogs: Listet die verfügbaren Datenbanken auf.
- sys_schemas: Listet die verfügbaren Schemata auf.
- sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
- sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
- sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
- sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
- sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
- sys_indexes: Beschreibt die verfügbaren Indizes.
Datenquellentabellen
Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:
- sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
- sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.
Abfrageinformationstabellen
Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:
- Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.
Sys_catalogs
Listet die verfügbaren Datenbanken auf.
Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:
SELECT * FROM sys_catalogs
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Datenbankname. |
Sys_schemas
Listet die verfügbaren Schemas auf.
Die folgende Abfrage ruft alle verfügbaren Schemas ab:
SELECT * FROM sys_schemas
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Datenbankname. |
SchemaName | String | Der Schema. |
Sys_tables
Listet die verfügbaren Tabellen auf.
Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:
SELECT * FROM sys_tables
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Die Datenbank, die die Tabelle oder Ansicht enthält. |
SchemaName | String | Das Schema, das die Tabelle oder Ansicht enthält. |
TableName | String | Der Name der Tabelle oder Ansicht. |
TableType | String | Der Tabellentyp (Tabelle oder Ansicht). |
Description | String | Eine Beschreibung der Tabelle oder Ansicht. |
IsUpdateable | Boolean | Ob die Tabelle aktualisiert werden kann. |
Sys_tablecolumns
Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Dateien“ zurück:
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Files'
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die die Tabelle oder Ansicht enthält. |
SchemaName | String | Das Schema, das die Tabelle oder Ansicht enthält. |
TableName | String | Der Name der Tabelle oder Ansicht, die die Spalte enthält. |
ColumnName | String | Der Spaltenname. |
DataTypeName | String | Der Name des Datentyps. |
DataType | Int32 | Eine Ganzzahl, die den Datentyp angibt. Dieser Wert wird zur Laufzeit basierend auf der Umfeld bestimmt. |
Length | Int32 | Die Speichergröße der Spalte. |
DisplaySize | Int32 | Die normale Maximalbreite der angegebenen Spalte in Zeichen. |
NumericPrecision | Int32 | Die maximale Anzahl von Ziffern in numerischen Daten. Die Spaltenlänge in Zeichen für Zeichen- und Datums-/Uhrzeitdaten. |
NumericScale | Int32 | Die Spaltenskala oder Anzahl der Ziffern rechts vom Dezimalpunkt. |
IsNullable | Boolean | Ob die Spalte Null enthalten kann. |
Description | String | Eine kurze Beschreibung der Spalte. |
Ordinal | Int32 | Die Sequenznummer der Spalte. |
IsAutoIncrement | String | Ob der Spaltenwert in festen Schritten zugewiesen wird. |
IsGeneratedColumn | String | Ob die Spalte generiert wird. |
IsHidden | Boolean | Ob die Spalte ausgeblendet ist. |
IsArray | Boolean | Ob die Spalte ein Array ist. |
IsReadOnly | Boolean | Ob die Spalte schreibgeschützt ist. |
IsKey | Boolean | Gibt an, ob ein von sys_tablecolumns zurückgegebenes Feld der Primärschlüssel der Tabelle ist. |
Sys_procedures
Listet die verfügbaren gespeicherten Prozeduren auf.
Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:
SELECT * FROM sys_procedures
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Die Datenbank, die die gespeicherte Prozedur enthält. |
SchemaName | String | Das Schema, das die gespeicherte Prozedur enthält. |
ProcedureName | String | Der Name der gespeicherten Prozedur. |
Description | String | Eine Beschreibung der gespeicherten Prozedur. |
ProcedureType | String | Der Typ der Prozedur, z. B. PROZEDUR oder FUNKTION. |
Sys_procedureparameters
Beschreibt Parameter gespeicherter Prozeduren.
Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur DownloadResource zurück:
SELECT * FROM sys_procedureparameters WHERE ProcedureName='DownloadResource' AND Direction=1 OR Direction=2
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die die gespeicherte Prozedur enthält. |
SchemaName | String | Der Name des Schema, das die gespeicherte Prozedur enthält. |
ProcedureName | String | Der Name der gespeicherten Prozedur, die den Parameter enthält. |
ColumnName | String | Der Name des gespeicherten Prozedurparameters. |
Direction | Int32 | Eine Ganzzahl, die dem Typ des Parameters entspricht: Eingabe (1), Eingabe/Ausgabe (2) oder Ausgabe (4). Parameter vom Typ Eingabe/Ausgabe können sowohl Eingabe- als auch Ausgabeparameter sein. |
DataTypeName | String | Der Name des Datentyps. |
DataType | Int32 | Eine Ganzzahl, die den Datentyp angibt. Dieser Wert wird zur Laufzeit basierend auf der Umfeld bestimmt. |
Length | Int32 | Die Anzahl der für Zeichendaten zulässigen Zeichen. Die Anzahl der für numerische Daten zulässigen Ziffern. |
NumericPrecision | Int32 | Die maximale Genauigkeit für numerische Daten. Die Spaltenlänge in Zeichen für Zeichen- und Datums-/Uhrzeitdaten. |
NumericScale | Int32 | Die Anzahl der Ziffern rechts vom Dezimalkomma in numerischen Daten. |
IsNullable | Boolean | Ob der Parameter Null enthalten kann. |
IsRequired | Boolean | Ob der Parameter zur Ausführung der Prozedur erforderlich ist. |
IsArray | Boolean | Ob der Parameter ein Array ist. |
Description | String | Die Beschreibung des Parameters. |
Ordinal | Int32 | Der Index des Parameters. |
Sys_keycolumns
Beschreibt die Primär- und Fremdschlüssel.
Die folgende Abfrage ruft den Primärschlüssel für die Tabelle „Files“ ab:
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Files'
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Schlüssel enthält. |
SchemaName | String | Der Name des Schema, das den Schlüssel enthält. |
TableName | String | Der Name der Tabelle, die den Schlüssel enthält. |
ColumnName | String | Der Name der Schlüsselspalte. |
IsKey | Boolean | Ob die Spalte ein Primärschlüssel in der Tabelle ist, auf die im Feld „TableName“ verwiesen wird. |
IsForeignKey | Boolean | Ob die Spalte ein Fremdschlüssel ist, auf den im Feld TableName verwiesen wird. |
PrimaryKeyName | String | Der Name des Primärschlüssels. |
ForeignKeyName | String | Der Name des Fremdschlüssels. |
ReferencedCatalogName | String | Die Datenbank, die den Primärschlüssel enthält. |
ReferencedSchemaName | String | Das Schema, das den Primärschlüssel enthält. |
ReferencedTableName | String | Die Tabelle, die den Primärschlüssel enthält. |
ReferencedColumnName | String | Der Spaltenname des Primärschlüssels. |
Sys_foreignkeys
Beschreibt die Fremdschlüssel.
Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Schlüssel enthält. |
SchemaName | String | Der Name des Schema, das den Schlüssel enthält. |
TableName | String | Der Name der Tabelle, die den Schlüssel enthält. |
ColumnName | String | Der Name der Schlüsselspalte. |
PrimaryKeyName | String | Der Name des Primärschlüssels. |
ForeignKeyName | String | Der Name des Fremdschlüssels. |
ReferencedCatalogName | String | Die Datenbank, die den Primärschlüssel enthält. |
ReferencedSchemaName | String | Das Schema, das den Primärschlüssel enthält. |
ReferencedTableName | String | Die Tabelle, die den Primärschlüssel enthält. |
ReferencedColumnName | String | Der Spaltenname des Primärschlüssels. |
ForeignKeyType | String | Gibt an, ob der Fremdschlüssel ein Importschlüssel (zeigt auf andere Tabellen) oder ein Exportschlüssel (referenziert von anderen Tabellen) ist. |
Sys_primarykeys
Beschreibt die Primärschlüssel.
Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:
SELECT * FROM sys_primarykeys
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Schlüssel enthält. |
SchemaName | String | Der Name des Schema, das den Schlüssel enthält. |
TableName | String | Der Name der Tabelle, die den Schlüssel enthält. |
ColumnName | String | Der Name der Schlüsselspalte. |
KeySeq | String | Die Sequenznummer des Primärschlüssels. |
KeyName | String | Der Name des Primärschlüssels. |
Sys_indexes
Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.
Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:
SELECT * FROM sys_indexes WHERE IsPrimary='false'
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Index enthält. |
SchemaName | String | Der Name des Schema, das den Index enthält. |
TableName | String | Der Name der Tabelle, die den Index enthält. |
IndexName | String | Der Indexname. |
ColumnName | String | Der Name der mit dem Index verknüpften Spalte. |
IsUnique | Boolean | Wahr, wenn der Index eindeutig ist. Andernfalls falsch. |
IsPrimary | Boolean | Wahr, wenn der Index ein Primärschlüssel ist. Andernfalls falsch. |
Type | Int16 | Ein ganzzahliger Wert, der dem Indextyp entspricht: Statistik (0), gruppiert (1), gehasht (2) oder Sonstiges (3). |
SortOrder | String | Die Sortierreihenfolge: A für aufsteigend oder D für absteigend. |
OrdinalPosition | Int16 | Die Sequenznummer der Spalte im Index. |
Sys_connection_props
Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.
Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:
jdbc:cdata:onedrive:config:
Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.
Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:
SELECT * FROM sys_connection_props WHERE Value <> ''
Spalten
Name | Typ | Beschreibung |
---|---|---|
Name | String | Der Name der Verbindungseigenschaft. |
ShortDescription | String | Eine kurze Beschreibung. |
Type | String | Der Datentyp der Verbindungseigenschaft. |
Default | String | Der Standardwert, sofern nicht explizit einer festgelegt wurde. |
Values | String | Eine durch Kommas getrennte Liste möglicher Werte. Wenn ein anderer Wert angegeben wird, wird ein Validierungsfehler ausgegeben. |
Value | String | Der von Ihnen festgelegte Wert oder ein vorkonfigurierter Standard. |
Required | Boolean | Ob für die Immobilie eine Anschlusspflicht besteht. |
Category | String | Die Kategorie der Verbindungseigenschaft. |
IsSessionProperty | String | Ob die Eigenschaft eine Sitzungseigenschaft ist, die zum Speichern von Informationen zur aktuellen Verbindung verwendet wird. |
Sensitivity | String | Die Vertraulichkeitsstufe der Eigenschaft. Diese gibt Aufschluss darüber, ob die Eigenschaft in Protokollierungs- und Authentifizierungsformularen verschleiert wird. |
PropertyName | String | Eine verkürzte Form des Verbindungseigenschaftsnamens in Camel-Case-Schreibweise. |
Ordinal | Int32 | Der Index des Parameters. |
CatOrdinal | Int32 | Der Index der Parameterkategorie. |
Hierarchy | String | Zeigt zugehörige abhängige Eigenschaften an, die zusammen mit dieser festgelegt werden müssen. |
Visible | Boolean | Informiert, ob die Eigenschaft in der Verbindungs-Benutzeroberfläche sichtbar ist. |
ETC | String | Diverse sonstige Informationen zum Objekt. |
Sys_sqlinfo
Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.
Entdecken der SELECT-Funktionen der Datenquelle
Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden. Andernfalls enthält die Spalte NO.
Name | Beschreibung | Mögliche Werte |
---|---|---|
AGGREGATE_FUNCTIONS | Unterstützte Aggregatfunktionen. | AVG , COUNT , MAX , MIN , SUM , DISTINCT |
COUNT | Ob die COUNT-Funktion unterstützt wird. | YES , NO |
IDENTIFIER_QUOTE_OPEN_CHAR | Das öffnende Zeichen, das zum Escapen eines Bezeichners verwendet wird. | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | Das abschließende Zeichen, das zum Escapen eines Bezeichners verwendet wird. | ] |
SUPPORTED_OPERATORS | Eine Liste unterstützter SQL-Operatoren. | = , > , < , >= , <= , <> , != , LIKE , NOT LIKE , IN , NOT IN , IS NULL , IS NOT NULL , AND , OR |
GROUP_BY | Ob GROUP BY unterstützt wird und wenn ja, in welchem Umfang. | NO , NO_RELATION , EQUALS_SELECT , SQL_GB_COLLATE |
STRING_FUNCTIONS | Unterstützte String-Funktionen. | LENGTH , CHAR , LOCATE , REPLACE , SUBSTRING , RTRIM , LTRIM , RIGHT , LEFT , UCASE , SPACE , SOUNDEX , LCASE , CONCAT , ASCII , REPEAT , OCTET , BIT , POSITION , INSERT , TRIM , UPPER , REGEXP , LOWER , DIFFERENCE , CHARACTER , SUBSTR , STR , REVERSE , PLAN , UUIDTOSTR , TRANSLATE , TRAILING , TO , STUFF , STRTOUUID , STRING , SPLIT , SORTKEY , SIMILAR , REPLICATE , PATINDEX , LPAD , LEN , LEADING , KEY , INSTR , INSERTSTR , HTML , GRAPHICAL , CONVERT , COLLATION , CHARINDEX , BYTE |
NUMERIC_FUNCTIONS | Unterstützte numerische Funktionen. | ABS , ACOS , ASIN , ATAN , ATAN2 , CEILING , COS , COT , EXP , FLOOR , LOG , MOD , SIGN , SIN , SQRT , TAN , PI , RAND , DEGREES , LOG10 , POWER , RADIANS , ROUND , TRUNCATE |
TIMEDATE_FUNCTIONS | Unterstützte Datums-/Uhrzeitfunktionen. | NOW , CURDATE , DAYOFMONTH , DAYOFWEEK , DAYOFYEAR , MONTH , QUARTER , WEEK , YEAR , CURTIME , HOUR , MINUTE , SECOND , TIMESTAMPADD , TIMESTAMPDIFF , DAYNAME , MONTHNAME , CURRENT_DATE , CURRENT_TIME , CURRENT_TIMESTAMP , EXTRACT |
REPLICATION_SKIP_TABLES | Zeigt an, dass während der Replikation Tabellen übersprungen wurden. | |
REPLICATION_TIMECHECK_COLUMNS | Ein Zeichenfolgenarray mit einer Liste von Spalten, die (in der angegebenen Reihenfolge) zur Überprüfung verwendet werden, ob sie während der Replikation als geänderte Spalte verwendet werden sollen. | |
IDENTIFIER_PATTERN | Zeichenfolgenwert, der angibt, welche Zeichenfolge für einen Bezeichner gültig ist. | |
SUPPORT_TRANSACTION | Gibt an, ob der Anbieter Transaktionen wie Commit und Rollback unterstützt. | YES , NO |
DIALECT | Gibt den zu verwendenden SQL-Dialekt an. | |
KEY_PROPERTIES | Gibt die Eigenschaften an, die die einheitliche Datenbank identifizieren. | |
SUPPORTS_MULTIPLE_SCHEMAS | Gibt an, ob für den Anbieter mehrere Schemas vorhanden sein können. | YES , NO |
SUPPORTS_MULTIPLE_CATALOGS | Gibt an, ob für den Anbieter mehrere Kataloge vorhanden sein können. | YES , NO |
DATASYNCVERSION | Die für den Zugriff auf diesen Treiber erforderliche Data Sync-Version. | Standard , Starter , Professional , Enterprise |
DATASYNCCATEGORY | Die Kategorie „Datensynchronisierung“ dieses Treiber. | Source , Destination , Cloud Destination |
SUPPORTSENHANCEDSQL | Ob erweiterte SQL-Funktionen über das hinaus, was die API bietet, unterstützt werden. | TRUE , FALSE |
SUPPORTS_BATCH_OPERATIONS | Ob Charge Operationen unterstützt werden. | YES , NO |
SQL_CAP | Alle unterstützten SQL-Funktionen für diesen Treiber. | SELECT , INSERT , DELETE , UPDATE , TRANSACTIONS , ORDERBY , OAUTH , ASSIGNEDID , LIMIT , LIKE , BULKINSERT , COUNT , BULKDELETE , BULKUPDATE , GROUPBY , HAVING , AGGS , OFFSET , REPLICATE , COUNTDISTINCT , JOINS , DROP , CREATE , DISTINCT , INNERJOINS , SUBQUERIES , ALTER , MULTIPLESCHEMAS , GROUPBYNORELATION , OUTERJOINS , UNIONALL , UNION , UPSERT , GETDELETED , CROSSJOINS , GROUPBYCOLLATE , MULTIPLECATS , FULLOUTERJOIN , MERGE , JSONEXTRACT , BULKUPSERT , SUM , SUBQUERIESFULL , MIN , MAX , JOINSFULL , XMLEXTRACT , AVG , MULTISTATEMENTS , FOREIGNKEYS , CASE , LEFTJOINS , COMMAJOINS , WITH , LITERALS , RENAME , NESTEDTABLES , EXECUTE , BATCH , BASIC , INDEX |
PREFERRED_CACHE_OPTIONS | Ein Zeichenfolgenwert gibt die bevorzugten Cacheoptionen an. | |
ENABLE_EF_ADVANCED_QUERY | Gibt an, ob der Treiber erweiterte Abfragen aus dem Entity Framework direkt unterstützt. Wenn nicht, werden die Abfragen clientseitig verarbeitet. | YES , NO |
PSEUDO_COLUMNS | Ein Zeichenfolgenarray, das die verfügbaren Pseudospalten angibt. | |
MERGE_ALWAYS | Wenn der Wert „true“ ist, wird der Merge-Modus in der Datensynchronisierung zwangsweise ausgeführt. | TRUE , FALSE |
REPLICATION_MIN_DATE_QUERY | Eine Abfrage zum Zurückgeben des Startdatums und der Startzeit der Replikation. | |
REPLICATION_MIN_FUNCTION | Ermöglicht einem Anbieter, den Formelnamen anzugeben, der zum Ausführen eines serverseitigen Minimums verwendet werden soll. | |
REPLICATION_START_DATE | Ermöglicht einem Anbieter, ein Replikationsstartdatum anzugeben. | |
REPLICATION_MAX_DATE_QUERY | Eine Abfrage zum Zurückgeben des Enddatums und der Endzeit der Replikation. | |
REPLICATION_MAX_FUNCTION | Ermöglicht einem Anbieter, den Formelnamen anzugeben, der zur Ausführung eines serverseitigen Max. verwendet werden soll. | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | Eine Liste von Tabellen, bei denen das Aufteilen der Replikation in Blöcke bei der ersten Replikation übersprungen wird. | |
CHECKCACHE_USE_PARENTID | Gibt an, ob die CheckCache-Anweisung für die übergeordnete Schlüsselspalte ausgeführt werden soll. | TRUE , FALSE |
CREATE_SCHEMA_PROCEDURES | Gibt gespeicherte Prozeduren an, die zum Generieren von Schema verwendet werden können. |
Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:
SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'
Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; siehe Datenmodell Abschnitt für weitere Informationen.
Spalten
Name | Typ | Beschreibung |
---|---|---|
NAME | String | Eine Komponente der SQL-Syntax oder eine Funktion, die auf dem Server verarbeitet werden kann. |
VALUE | String | Details zum unterstützten SQL bzw. zur SQL-Syntax. |
Systemidentität
Gibt Informationen zu versuchten Änderungen zurück.
Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:
SELECT * FROM sys_identity
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id | String | Die von einer Operation zurückgegebene, von der Datenbank generierte ID. |
Batch | String | Eine Kennung für den Charge. 1 für einen einzelnen Operation. |
Operation | String | Das Ergebnis der Operation im Charge: EINGEFÜGT, AKTUALISIERT oder GELÖSCHT. |
Message | String | SUCCESS oder eine Fehlermeldung, wenn das Update im Charge fehlgeschlagen ist. |
Datentypzuordnung
Datentypzuordnungen
Der Connector ordnet Typen aus der Datenquelle dem entsprechenden im Schema verfügbaren Datentyp zu. Die folgende Tabelle dokumentiert diese Zuordnungen.
Microsoft OneDrive (OData V4) | Schema |
---|---|
Edm.Binary | binär |
Edm.Boolean | |
Edm.Date | Datum/Uhrzeit |
Edm.DateTimeOffset | Datum/Uhrzeit |
Edm.Decimal | Dezimal |
Edm.Double | doppelt |
Edm.Guid | Anleitung |
Edm.Int32 | int |
Edm.String | Zeichenfolge |
Edm.TimeOfDay | Zeit |
Erweiterte Konfigurationseigenschaften
Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.
Eigenschaft | Beschreibung |
---|---|
AuthScheme | Der bei der Verbindung mit Microsoft OneDrive zu verwendende Authentifizierungstyp. |
Eigenschaft | Beschreibung |
---|---|
AzureTenant | Der Microsoft Online-Mandant, der für den Datenzugriff verwendet wird. Wenn nicht angegeben, wird Ihr Standardmandant verwendet. |
AzureEnvironment | Die beim Herstellen einer Verbindung zu verwendende Azure-Umgebung. |
Eigenschaft | Beschreibung |
---|---|
InitiateOAuth | Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten. |
OAuthClientId | Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthClientSecret | Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthGrantType | Der Berechtigungstyp für den OAuth-Flow. |
Eigenschaft | Beschreibung |
---|---|
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
Eigenschaft | Beschreibung |
---|---|
Location | Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren. |
BrowsableSchemas | Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA, TabelleB, TabelleC. |
Views | Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA, AnsichtB, AnsichtC. |
Eigenschaft | Beschreibung |
---|---|
DirectoryRetrievalDepth | Geben Sie an, in wie vielen Ordnern Sie Ergebnisse für die Tabellen „Ordner“, „Dateien“, „Freigegebene Ressourcen“ und „Berechtigungen“ erhalten möchten. Die Ressourcen direkt im Stammverzeichnis befinden sich in Tiefe 0. Die Ressourcen einen Ordner tiefer befinden sich in Tiefe 1 und so weiter. Sie können den Wert -1 angeben, um alle Daten in einem Laufwerk abzurufen, unabhängig von der Tiefe, in der sie sich befinden. |
DriveId | Die ID des Laufwerks, das Sie verwenden möchten. |
ListGroupDrives | Wählen Sie, ob Ihre Gruppenlaufwerke bei der Abfrage der Laufwerkstabelle aufgelistet werden sollen oder nicht. |
MaxRows | Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden. |
Other | Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet. |
PseudoColumns | Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
Authentifizierung
Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
AuthScheme | Der bei der Verbindung mit Microsoft OneDrive zu verwendende Authentifizierungstyp. |
AuthScheme
Der Authentifizierungstyp, der bei der Verbindung mit Microsoft OneDrive verwendet werden soll. Derzeit nur AzureServicePrincipal
wird unterstützt
Mögliche Werte
AzureServicePrincipal
Datentyp
string
Standardwert
AzureServicePrincipal
Hinweise
- AzureServicePrincipal: Legen Sie dies fest, um sich als Microsoft Entra-Dienstprinzipal zu authentifizieren.
Azure Authentifizierung
Dieser Abschnitt enthält eine vollständige Liste der Azure-Authentifizierungseigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
AzureTenant | Der Microsoft Online-Mandant, der für den Datenzugriff verwendet wird. Wenn nicht angegeben, wird Ihr Standardmandant verwendet. |
AzureEnvironment | Die beim Herstellen einer Verbindung zu verwendende Azure-Umgebung. |
AzureTenant
Der Microsoft Online-Mandant, der für den Datenzugriff verwendet wird. Wenn nicht angegeben, wird Ihr Standardmandant verwendet.
Datentyp
string
Standardwert
""
Hinweise
Der Microsoft Online-Mandant, der für den Datenzugriff verwendet wird. Beispiel: „example.onmicrosoft.com“. Alternativ können Sie die Mandanten-ID angeben. Dieser Wert ist die Verzeichnis-ID im Azure-Portal > Microsoft Entra ID > Eigenschaften.
Normalerweise ist es nicht notwendig, den Mandanten anzugeben. Dies kann von Microsoft automatisch ermittelt werden, wenn der OAuthGrantType verwendet wird auf CODE (Standard) eingestellt. Es kann jedoch fehlschlagen, wenn der Benutzer mehreren Mandanten angehört. Zum Beispiel, wenn ein Administrator von Domäne A einen Benutzer von Domäne B als Gastbenutzer einlädt. Der Benutzer gehört nun zu beiden Mandanten. Es ist eine gute Praxis, den Mandanten anzugeben, obwohl es im Allgemeinen funktionieren sollte, ohne ihn angeben zu müssen.
AzureTenant
ist beim Festlegen von OAuthGrantType erforderlich zu CLIENT. Bei der Verwendung von Client-Anmeldeinformationen gibt es keinen Benutzerkontext. Die Anmeldeinformationen werden aus dem Kontext der App selbst übernommen. Microsoft erlaubt zwar weiterhin den Abruf von Client-Anmeldeinformationen ohne Angabe des Mandanten, aber die Wahrscheinlichkeit, den spezifischen Mandanten auszuwählen, mit dem Sie arbeiten möchten, ist viel geringer. Aus diesem Grund benötigen wir AzureTenant
muss bei allen Client-Anmeldeinformationen-Verbindungen explizit angegeben werden, um sicherzustellen, dass Sie Anmeldeinformationen erhalten, die für die Domäne gelten, mit der Sie eine Verbindung herstellen möchten.
Azure-Umgebung
Die beim Herstellen einer Verbindung zu verwendende Azure-Umgebung.
Mögliche Werte
GLOBAL
, CHINA
, USGOVT
, USGOVTDOD
Datentyp
string
Standardwert
GLOBAL
Hinweise
In den meisten Fällen funktioniert es, die Umfeld auf global eingestellt zu lassen. Wenn Ihr Azure-Konto jedoch einer anderen Umfeld hinzugefügt wurde, wird die AzureEnvironment
kann verwendet werden, um die Umfeld anzugeben. Die verfügbaren Werte sind GLOBAL, CHINA, USGOVT, USGOVTDOD.
OAuth
Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
InitiateOAuth | Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten. |
OAuthClientId | Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthClientSecret | Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthGrantType | Der Berechtigungstyp für den OAuth-Flow. |
OAuth initiieren
Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten.
Mögliche Werte
GETANDREFRESH
Datentyp
string
Standardwert
GETANDREFRESH
Hinweise
Die folgende Option wird unterstützt:
GETANDREFRESH
: Gibt an, dass der gesamte OAuth-Flow vom Connector verarbeitet wird. Wenn derzeit kein Token vorhanden ist, wird es abgerufen. Wenn ein Token vorhanden ist, wird es bei Bedarf aktualisiert.
OAuthClientId
Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.
Datentyp
string
Standardwert
""
Hinweise
Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId
-Wert, manchmal auch Consumer-Schlüssel genannt, und ein Client-Geheimnis, das OAuthClientSecret.
OAuthClientSecret
Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.
Datentyp
string
Standardwert
""
Hinweise
Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie das Client-Geheimnis, auch Consumer-Geheimnis genannt. Legen Sie das Client-Geheimnis als fest OAuthClientSecret
-Eigenschaft.
Sie erhalten außerdem eine OAuthClientId, auch Consumer-Key genannt.
OAuth-Zugriffstoken
Der Zugriffstoken für die Verbindung per OAuth.
Datentyp
string
Standardwert
""
Hinweise
Der OAuthAccessToken
Eigenschaft wird für die Verbindung über OAuth verwendet. Die OAuthAccessToken
wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es hat ein serverabhängiges Timeout und kann zwischen Anfragen wiederverwendet werden.
Das Zugriffstoken wird anstelle Ihres Benutzernamens und Passworts verwendet. Das Zugriffstoken schützt Ihre Anmeldeinformationen, indem es sie auf dem Server speichert.
OAuthGrantType
Der Berechtigungstyp für den OAuth-Flow.
Mögliche Werte
CLIENT
Datentyp
string
Standardwert
CLIENT
Hinweise
Der Berechtigungstyp für den OAuth-Flow. Nur die CLIENT
-Option wird unterstützt.
OAuthSettingsLocation
Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH eingestellt ist. Alternativ können Sie diesen Speicherort im Speicher behalten, indem Sie einen Wert angeben, der mit beginnt 'memory://'
.
Datentyp
string
Standardwert
%APPDATA%\CData\Acumatica Data Provider\OAuthSettings.txt
Hinweise
Wenn InitiateOAuth ist auf gesetzt GETANDREFRESH
oder REFRESH
, der Treiber speichert OAuth-Werte, damit der Benutzer die OAuth-Verbindungseigenschaften nicht manuell eingeben muss und die Anmeldeinformationen über Verbindungen oder Prozesse hinweg gemeinsam genutzt werden können.
Anstatt einen Dateipfad anzugeben, können Sie auch den Speicherort angeben. Speicherorte werden durch einen Wert angegeben, der mit 'memory://'
gefolgt von einer eindeutigen Kennung für diesen Satz von Anmeldeinformationen (z. B. memory://user1). Die Kennung können Sie frei wählen, sie sollte jedoch für den Benutzer eindeutig sein. Im Gegensatz zur dateibasierten Speicherung, bei der die Anmeldeinformationen über Verbindungen hinweg bestehen bleiben, werden die Anmeldeinformationen bei der Speicherspeicherung in den statischen Speicher geladen und die Anmeldeinformationen werden für die Dauer des Prozesses unter Verwendung derselben Kennung zwischen Verbindungen geteilt. Um Anmeldeinformationen außerhalb des aktuellen Prozesses beizubehalten, müssen Sie die Anmeldeinformationen vor dem Schließen der Verbindung manuell speichern. Auf diese Weise können Sie sie in der Verbindung festlegen, wenn der Prozess erneut gestartet wird. Sie können OAuth-Eigenschaftswerte mit einer Abfrage an abrufen sys_connection_props
Systemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.
Der Standardspeicherort ist „%APPDATA%\CData\ Acumatica Data Provider\OAuthSettings.txt“ mit %APPDATA%
auf das Konfigurationsverzeichnis des Benutzers gesetzt. Die Standardwerte sind
- Windows: "
register://%DSN
" - Unix: "%AppData%..."
wobei DSN der Name des aktuellen DSN ist, der in der offenen Verbindung verwendet wird.
Die folgende Tabelle listet den Wert von auf %APPDATA%
nach Operationssystem:
Plattform | %APPDATA% |
---|---|
Windows | Der Wert der Umfeld APPDATA |
Linux | ~/.config |
Rückruf-URL
Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.
Datentyp
string
Standardwert
""
Hinweise
Während des Authentifizierungsprozesses leitet der OAuth-Autorisierungsserver den Benutzer an diese URL weiter. Dieser Wert muss mit der Rückruf URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.
OAuthVerifier
Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode.
Datentyp
string
Standardwert
""
Hinweise
Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. Dieser kann auf Systemen verwendet werden, auf denen kein Browser gestartet werden kann, z. B. auf Headless-Systemen.
Authentifizierung auf Headless-Maschinen
Siehe, um die zu erhalten OAuthVerifier
Wert.
OAuthSettingsLocation festlegen zusammen mit OAuthVerifier
. Beim Verbinden tauscht der Connector die OAuthVerifier
für die OAuth-Authentifizierungstoken und speichert sie verschlüsselt am angegebenen Speicherort. Setzen Sie InitiateOAuth zu GETANDREFRESH, um den Austausch zu automatisieren.
Sobald die OAuth-Einstellungsdatei generiert wurde, können Sie entfernen OAuthVerifier
aus den Verbindungseigenschaften und verbinden Sie sich mit OAuthSettingsLocation festgelegt.
Um die OAuth-Tokenwerte automatisch zu aktualisieren, legen Sie OAuthSettingsLocation fest und setzen Sie zusätzlich InitiateOAuth zum AKTUALISIEREN.
OAuthRefreshToken
Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken.
Datentyp
string
Standardwert
""
Hinweise
Der OAuthRefreshToken
Eigenschaft wird verwendet, um den OAuthAccessToken zu aktualisieren bei Verwendung der OAuth-Authentifizierung.
OAuthLäuftAbIn
Die Lebensdauer des OAuth AccessToken in Sekunden.
Datentyp
string
Standardwert
""
Hinweise
Mit OAuthTokenTimestamp kombinieren, um zu bestimmen, wann der AccessToken abläuft.
OAuthTokenTimestamp
Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde.
Datentyp
string
Standardwert
""
Hinweise
Kombinieren Sie es mit OAuthExpiresIn, um zu bestimmen, wann das AccessToken abläuft.
JWT OAuth
Dieser Abschnitt enthält eine vollständige Liste der JWT OAuth-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
OAuthJWTCert | Der JWT-Zertifikatspeicher. |
OAuthJWTCertType | Der Typ des Schlüsselspeichers, der das JWT-Zertifikat enthält. |
OAuthJWTCertPassword | Das Passwort für das OAuth JWT-Zertifikat. |
OAuthJWTCertSubject | Der Betreff des OAuth-JWT-Zertifikats. |
OAuthJWTCert
Der JWT-Zertifikatspeicher.
Datentyp
string
Standardwert
""
Hinweise
Der Name des Zertifikatspeichers für das Client-Zertifikat.
Der OAuthJWTCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an OAuthJWTCert
. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in OAuthJWTCertPassword an.
OAuthJWTCert
wird in Verbindung mit OAuthJWTCertSubject verwendet
Feld, um Client-Zertifikate anzugeben. Wenn OAuthJWTCert
hat einen Wert und OAuthJWTCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Bitte beachten Sie das OAuthJWTCertSubject für weitere Einzelheiten.
Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.
Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:
Eigenschaft | Beschreibung |
---|---|
MY | Ein Zertifikatsspeicher, der persönliche Zertifikate mit den zugehörigen privaten Schlüsseln enthält. |
CA | Zertifikate der Zertifizierungsstelle. |
ROOT | Stammzertifikate. |
SPC | Zertifikate von Softwareherstellern. |
In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.
Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei (d. h. PKCS12-Zertifikatsspeicher) gesetzt werden.
OAuthJWTCertType
Der Typ des Schlüsselspeichers, der das JWT-Zertifikat enthält.
Datentyp
string
Standardwert
USER
Hinweise
Diese Eigenschaft kann einen der folgenden Werte annehmen:
Eigenschaft | Beschreibung |
---|---|
USER | Unter Windows gibt dies an, dass es sich bei dem Zertifikatspeicher um einen Zertifikatspeicher handelt, der dem aktuellen Benutzer gehört. Hinweis: Dieser Speichertyp ist in Java nicht verfügbar. |
MACHINE | Für Windows gibt dies an, dass es sich bei dem Zertifikatspeicher um einen Maschinenspeicher handelt. Hinweis: Dieser Speichertyp ist in Java nicht verfügbar. |
PFXFILE | Der Zertifikatsspeicher ist der Name einer PFX-Datei (PKCS12), die Zertifikate enthält. |
PFXBLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die einen Zertifikatsspeicher im PFX-Format (PKCS12) darstellt. |
JKSFILE | Der Zertifikatsspeicher ist der Name einer Java Key Store (JKS)-Datei, die Zertifikate enthält. Hinweis: Dieser Speichertyp ist nur in Java verfügbar. |
JKSBLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die einen Zertifikatsspeicher im Java Key Store-Format (JKS) darstellt. Hinweis: Dieser Speichertyp ist nur in Java verfügbar. |
PEMKEY_FILE | Der Zertifikatsspeicher ist der Name einer PEM-codierten Datei, die einen privaten Schlüssel und ein optionales Zertifikat enthält. |
PEMKEY_BLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (base64-codiert), die einen privaten Schlüssel und ein optionales Zertifikat enthält. |
PUBLIC_KEY_FILE | Der Zertifikatsspeicher ist der Name einer Datei, die ein PEM- oder DER-codiertes öffentliches Schlüsselzertifikat enthält. |
PUBLIC_KEY_BLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die ein PEM- oder DER-codiertes öffentliches Schlüsselzertifikat enthält. |
SSHPUBLIC_KEY_FILE | Der Zertifikatsspeicher ist der Name einer Datei, die einen öffentlichen Schlüssel im SSH-Stil enthält. |
SSHPUBLIC_KEY_BLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die einen öffentlichen Schlüssel im SSH-Stil enthält. |
P7BFILE | Der Zertifikatsspeicher ist der Name einer PKCS7-Datei, die Zertifikate enthält. |
PPKFILE | Der Zertifikatsspeicher ist der Name einer Datei, die einen PPK (PuTTY Private Key) enthält. |
XMLFILE | Der Zertifikatsspeicher ist der Name einer Datei, die ein Zertifikat im XML-Format enthält. |
XMLBLOB | Der Zertifikatsspeicher ist eine Zeichenfolge, die ein Zertifikat im XML-Format enthält. |
OAuthJWTCertPasswort
Das Passwort für das OAuth JWT-Zertifikat.
Datentyp
string
Standardwert
""
Hinweise
Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort anzugeben, damit der Zertifikatspeicher geöffnet werden kann.
OAuthJWTCertSubject
Der Betreff des OAuth JWT-Zertifikats.
Datentyp
string
Standardwert
*
Hinweise
Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.
Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten.
Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.
Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.
Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Zum Beispiel „CN=www.server.com, OU=test, C=US, E=example@jbexample.com“. Allgemeine Felder und ihre Bedeutungen werden unten angezeigt.
Feld | Bedeutung |
---|---|
CN | Allgemeiner Name. Dies ist normalerweise ein Host wie www.server.com. |
O | Organisation |
OU | Organisationseinheit |
L | Ort |
S | Staat |
C | Land |
E | Email Adresse |
Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.
SSL
Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
SSLServerCert
Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL.
Datentyp
string
Standardwert
""
Hinweise
Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.
Diese Eigenschaft kann folgende Formen annehmen:
Beschreibung | Beispiel |
---|---|
Ein vollständiges PEM-Zertifikat (Beispiel der Kürze halber gekürzt) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
Ein Pfad zu einer lokalen Datei, die das Zertifikat enthält | C:\\cert.cer |
Der öffentliche Schlüssel (Beispiel der Kürze halber gekürzt) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
Der MD5-Fingerabdruck (Hex-Werte können auch durch Leerzeichen oder Doppelpunkte getrennt sein) | ecadbdda5a1529c58a1e9e09828d70e4 |
Der SHA1-Fingerabdruck (Hex-Werte können auch durch Leerzeichen oder Doppelpunkte getrennt sein) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.
Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).
Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.
Schema
Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
Location | Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren. |
BrowsableSchemas | Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA, TabelleB, TabelleC. |
Views | Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA, AnsichtB, AnsichtC. |
Standort
Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.
Datentyp
string
Standardwert
%APPDATA%\OneDrive Data Provider\Schema
Hinweise
Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location
Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen möchten (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.
Wenn nichts angegeben wird, ist der Standardspeicherort „%APPDATA%\OneDrive Data Provider\Schema“ mit %APPDATA%
wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:
Plattform | %APPDATA% |
---|---|
Windows | Der Wert der Umfeld APPDATA |
Mac | ~/Bibliothek/Anwendungsunterstützung |
Linux | ~/.config |
DurchsuchbareSchemas
Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Datentyp
string
Standardwert
""
Hinweise
Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.
Tabellen
Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.
Datentyp
string
Standardwert
""
Hinweise
Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.
Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.
Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.
Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.
Ansichten
Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.
Datentyp
string
Standardwert
""
Hinweise
Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.
Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.
Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.
Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.
Verschiedenes
Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
DirectoryRetrievalDepth | Geben Sie an, in wie vielen Ordnern Sie Ergebnisse für die Tabellen „Ordner“, „Dateien“, „Freigegebene Ressourcen“ und „Berechtigungen“ erhalten möchten. Die Ressourcen direkt im Stammverzeichnis befinden sich in Tiefe 0. Die Ressourcen einen Ordner tiefer befinden sich in Tiefe 1 und so weiter. Sie können den Wert -1 angeben, um alle Daten in einem Laufwerk abzurufen, unabhängig von der Tiefe, in der sie sich befinden. |
DriveId | Die ID des Laufwerks, das Sie verwenden möchten. |
IncludeFoldersWithFiles | Wählen Sie, ob Sie Ordner in die Dateiansicht einschließen möchten. |
ListGroupDrives | Wählen Sie, ob Ihre Gruppenlaufwerke bei der Abfrage der Laufwerkstabelle aufgelistet werden sollen oder nicht. |
MaxRows | Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln. |
Other | Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet. |
PseudoColumns | Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
UserDefinedViews | Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält. |
Verzeichnisabruftiefe
Geben Sie an, in wie vielen Ordnern Sie Ergebnisse für die Tabellen „Ordner“, „Dateien“, „Freigegebene Ressourcen“ und „Berechtigungen“ erhalten möchten. Die Ressourcen direkt im Stammverzeichnis befinden sich in Tiefe 0. Die Ressourcen einen Ordner tiefer befinden sich in Tiefe 1 und so weiter. Sie können einen Wert von -1 angeben, um alle Daten in einem Laufwerk abzurufen, unabhängig von der Tiefe, in der sie sich befinden.
Datentyp
string
Standardwert
5
Hinweise
Diese Eigenschaft muss in der Verbindungszeichenfolge festgelegt werden. Andernfalls verwendet der Treiber den Standardwert „DirectoryRetrievalDepth=5“.
Laufwerks-ID
Die ID des Laufwerks, das Sie verwenden möchten.
Datentyp
string
Standardwert
""
Hinweise
Standardmäßig verwendet der Anbieter das Hauptlaufwerk des angemeldeten Benutzers.
Sie können alle möglichen Laufwerks-IDs herausfinden, indem Sie die Tabelle „Laufwerke“ abfragen.
Ordner mit Dateien einschließen
Wählen Sie aus, ob Sie Ordner in die Dateiansicht einschließen möchten.
Datentyp
bool
Standardwert
false
Hinweise
Standardmäßig werden die Ordner nicht in der Dateiansicht angezeigt. Setzen Sie diese Eigenschaft auf „true“, um Ordner in die Dateiansicht einzuschließen. Sie können mithilfe der Spalte „ResourceType“ zwischen Dateien und Ordnern unterscheiden.
LaufwerkeGruppenAuflisten
Wählen Sie, ob Ihre Gruppenlaufwerke bei der Abfrage der Laufwerkstabelle aufgelistet werden sollen oder nicht.
Datentyp
bool
Standardwert
false
Hinweise
Standardmäßig zeigt der Anbieter nur die Laufwerke des Benutzers an.
MaxRows
Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.
Datentyp
int
Standardwert
-1
Hinweise
Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.
Andere
Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.
Datentyp
string
Standardwert
""
Hinweise
Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.
Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.
Integration und Formatierung
Eigenschaft | Beschreibung |
---|---|
DefaultColumnSize | Legt die Standardlänge von Zeichenfolgefeldern fest, wenn die Datenquelle keine Spaltenlänge in den Metadaten bereitstellt. Der Standardwert ist 2000. |
ConvertDateTimeToGMT | Bestimmt, ob Datums-/Uhrzeitwerte in GMT statt in die lokale Zeit des Computers konvertiert werden sollen. |
RecordToFile=filename | Protokolliert den zugrunde liegenden Socket-Datenübertragungsvorgang in die angegebene Datei. |
Pseudospalten
Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.
Datentyp
string
Standardwert
""
Hinweise
Diese Einstellung ist besonders hilfreich im Entity Framework, da Sie dort keinen Wert für eine Pseudospalte festlegen können, es sei denn, es handelt sich um eine Tabellenspalte. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das Zeichen „*“ verwenden, um alle Tabellen und alle Spalten einzuschließen, z. B. „*=*“.
Zeitüberschreitung
Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.
Datentyp
int
Standardwert
60
Hinweise
Wenn Timeout
= 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.
Wenn Timeout
abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.
BenutzerdefinierteAnsichten
Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.
Datentyp
string
Standardwert
""
Hinweise
Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json
. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.
Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews
Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.
Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:
- Jedes Stammelement definiert den Namen einer Ansicht.
- Jedes Stammelement enthält ein untergeordnetes Element namens
query
, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.
Zum Beispiel:
{
"MyView": {
"query": "SELECT * FROM Files WHERE MyColumn = 'value'"
},
"MyView2": {
"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
}
}
Verwenden Sie UserDefinedViews
Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:
"UserDefinedViews", C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json
Beachten Sie, dass der angegebene Pfad nicht in Anführungszeichen steht.