Zum Inhalt springen

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:

    1. Melden Sie sich an bei https://portal.azure.com.
    2. Wählen Sie im linken Navigationsbereich Microsoft Entra ID, Dann applicationRegistrations.
    3. Klicken Sie auf New registration.
    4. Geben Sie einen Namen für die Anwendung ein.
    5. 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.
    6. Setzen Sie die Weiterleitungs URL auf http://localhost:33333 (Standard des Connectors) ODER geben Sie einen anderen Port an und setzen Sie CallbackURL an die genaue Antwort-URL, die Sie definiert haben.
    7. Klicken Sie auf Register, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
      Notieren Sie den Wert in Application (client) ID als OAuthClientId und das Directory (tenant) ID als AzureTenant.
    8. 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ählen Upload certificate, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch.
      • Zum Erstellen eines neuen Client-Geheimnisses: In Certificates & Secrets, wählen New 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 zum OAuthClientSecret.
    9. Wählen Sie API Permissions > Add > Delegated permissions.
    10. 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.
    11. Speichern Sie Ihre Änderungen.
    12. 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:

    1. Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
    2. Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
    3. Öffnen Sie die Subscriptions-Seite.
    4. Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
    5. Öffnen Sie die Access control (IAM).
    6. Wählen Sie Add > Add role assignment. Microsoft OneDrive öffnet das Add role assignment Seite.
    7. Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu Owner.

    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:

    1. Lassen Sie einen Administrator sich anmelden bei portal.azure.com.
    2. Navigieren Sie zu App Registrations und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben.
    3. Unter API Permissions, klick Grant 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:

  1. 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:

    1. Melden Sie sich an bei https://portal.azure.com.
    2. Wählen Sie im linken Navigationsbereich Microsoft Entra ID, Dann applicationRegistrations.
    3. Klicken Sie auf New registration.
    4. Geben Sie einen Namen für die Anwendung ein.
    5. 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.
    6. Setzen Sie die Weiterleitungs URL auf http://localhost:33333 (Standard des Connectors) ODER geben Sie einen anderen Port an und setzen Sie CallbackURL an die genaue Antwort-URL, die Sie definiert haben.
    7. Klicken Sie auf Register, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
      Notieren Sie den Wert in Application (client) ID als OAuthClientId und das Directory (tenant) ID als AzureTenant.
    8. 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ählen Upload certificate, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch.
      • Zum Erstellen eines neuen Client-Geheimnisses: In Certificates & Secrets, wählen New 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 zum OAuthClientSecret.
    9. Wählen Sie API Permissions > Add > Delegated permissions.
    10. 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.
    11. Speichern Sie Ihre Änderungen.
    12. 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:

    1. Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
    2. Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
    3. Öffnen Sie die Subscriptions-Seite.
    4. Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
    5. Öffnen Sie die Access control (IAM).
    6. Wählen Sie Add > Add role assignment. Microsoft OneDrive öffnet das Add role assignment Seite.
    7. Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu Owner.

    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:

    1. Lassen Sie einen Administrator sich anmelden bei portal.azure.com.
    2. Navigieren Sie zu App Registrations und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben.
    3. Unter API Permissions, klick Grant Consent.

    Dadurch erhält Ihre Anwendung Berechtigungen für den Mandanten, unter dem sie erstellt wurde.

.

  1. Weisen Sie der Anwendung eine Rolle zu:
    1. Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
    2. Öffnen Sie die Subscriptions-Seite.
    3. Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
    4. Öffnen Sie die Access control (IAM).
    5. Wählen Sie Add > Add role assignment. Microsoft OneDrive öffnet das Add role assignment Seite.
    6. Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu Owner.

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:

  1. Melden Sie sich an bei https://portal.azure.com.
  2. Wählen Sie im linken Navigationsbereich Microsoft Entra ID, Dann applicationRegistrations.
  3. Klicken Sie auf New registration.
  4. Geben Sie einen Namen für die Anwendung ein.
  5. 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.
  6. Setzen Sie die Weiterleitungs URL auf http://localhost:33333 (Standard des Connectors) ODER geben Sie einen anderen Port an und setzen Sie CallbackURL an die genaue Antwort-URL, die Sie definiert haben.
  7. Klicken Sie auf Register, um die neue Anwendung zu registrieren. Ein Anwendungsverwaltungsbildschirm wird angezeigt.
    Notieren Sie den Wert in Application (client) ID als OAuthClientId und das Directory (tenant) ID als AzureTenant.
  8. 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ählen Upload certificate, und laden Sie dann das Zertifikat von Ihrem lokalen Computer hoch.
    • Zum Erstellen eines neuen Client-Geheimnisses: In Certificates & Secrets, wählen New 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 zum OAuthClientSecret.
  9. Auswählen API Permissions > Add > Delegated permissions.
  10. 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.
  11. Speichern Sie Ihre Änderungen.
  12. 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:

  1. Erstellen Sie eine benutzerdefinierte OAuth AD-Anwendung, wie oben beschrieben.
  2. Verwenden Sie die Suchleiste, um nach dem Abonnementdienst zu suchen.
  3. Öffnen Sie die Subscriptions Seite.
  4. Wählen Sie das Abonnement aus, dem die Anwendung zugewiesen werden soll.
  5. Öffnen Sie die Access control (IAM).
  6. Auswählen Add > Add role assignment. Microsoft OneDrive öffnet das Add role assignment Seite.
  7. Weisen Sie Ihrer benutzerdefinierten Microsoft Entra ID Anwendung die Rolle zu Owner.

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:

  1. Lassen Sie einen Administrator sich anmelden bei portal.azure.com.
  2. Navigieren Sie zu App Registrations und suchen Sie die benutzerdefinierte OAuth-Anwendung, die Sie erstellt haben.
  3. Unter API Permissions, klick Grant 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:

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.

Authentifizierung

Eigenschaft Beschreibung
AuthScheme Der bei der Verbindung mit Microsoft OneDrive zu verwendende Authentifizierungstyp.

Azure-Authentifizierung

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.

OAuth

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.

SSL

Eigenschaft Beschreibung
SSLServerCert Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL.

Schema

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.

Verschiedenes

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_propsSystemtabelle. 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.