Instagram Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8936 des Connectors.

Erste Schritte

Unterstützung für Instagram Version

Der Connector modelliert Entitäten in der Instagram Graph API als relationale Tabellen.

Herstellen einer Verbindung

Mit Instagram verbinden

Instagram unterstützt nur OAuth-Authentifizierung.

Desktop-Anwendungen

Es wird eine eingebettete OAuth-Anwendung bereitgestellt, die die OAuth-Desktop-Authentifizierung vereinfacht. Alternativ können Sie eine benutzerdefinierte OAuth-Anwendung erstellen. Siehe Erstellen einer benutzerdefinierten OAuth-App für Informationen zum Erstellen benutzerdefinierter Anwendungen und Gründe dafür.

OAuth-Zugriffstoken abrufen und aktualisieren

Nachdem Sie Folgendes festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.
• OAuthClientId (nur benutzerdefinierte Anwendungen): Legen Sie hier die Client-ID fest, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret (nur benutzerdefinierte Anwendungen): Legen Sie hier das Client-Geheimnis fest, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• CallbackURL (nur benutzerdefinierte Anwendung): Legen Sie dies auf die Umleitungs-URI fest, die Sie bei der Registrierung Ihrer Anwendung definiert haben.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Instagram in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von Instagram und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden an dem in angegebenen Ort gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Der Connector aktualisiert das Zugriffstoken automatisch, wenn es abläuft.

Erstellen einer benutzerdefinierten OAuth-App

Wann sollte eine benutzerdefinierte OAuth-App erstellt werden?

bettet OAuth-Anwendungsanmeldeinformationen mit Branding ein, die bei der Verbindung über eine Desktop-Anwendung verwendet werden können. Webanwendungen erfordern eine benutzerdefinierte OAuth-Anwendung. Sie können Ihre eigenen OAuth-Anwendungsanmeldeinformationen verwenden, wenn Sie Folgendes möchten:

• das Branding des Authentifizierungsdialogs steuern
• die Umleitungs-URI steuern, zu der die Anwendung den Benutzer nach der Authentifizierung umleitet
• die Berechtigungen anpassen, die Sie vom Benutzer anfordern

Zugriff auf Instagram Daten erlauben

Um Benutzern die Verbindung über den Connector zu ermöglichen, führen Sie die folgenden Aufgaben aus:

1. Verbinden Sie eine Facebook-Seite mit einem Instagram Konto.
2. Erstellen und registrieren Sie den Connector als App bei Instagram.
3. Senden Sie Ihre App zur Überprüfung an Facebook.

Eine Facebook-Seite mit einem Instagram Konto verbinden

Um auf Instagram Daten zugreifen zu können, benötigen Benutzer eine Rolle auf einer Seite, die mit einem Instagram-Konto verknüpft ist. Jeder Benutzer mit einer Rolle auf der Seite hat Zugriff.

Um eine Seite und ein Instagram Konto zu verbinden, melden Sie sich bei Facebook an und klicken Sie in den Einstellungen Ihrer Seite auf Instagram, und melden Sie sich bei Ihrem Instagram Konto an. Wenn Ihr Konto kein Instagram Geschäftskonto ist, folgen Sie den Anweisungen zum Einrichten eines Geschäftsprofils.

Erstellen und Registrieren der App

Registrieren Sie eine App, um die Werte für zu erhalten OAuthClientId Und OAuthClientSecret Eigenschaften. Die OAuth-Client-Anmeldeinformationen authentifizieren den Connector gegenüber Facebook.

1. Melden Sie sich bei Facebook an und navigieren Sie zu https://developers.facebook.com/apps.
2. Erstellen Sie eine neue App und klicken Sie auf Settings > Basic. Der OAuthClientId ist die angezeigte App-ID. Das OAuthClientSecret ist das App-Geheimnis.
3. Klicken Sie auf Add Platform und wählen Sie Website. Geben Sie eine Site URL ein. Dieser Wert wird bei der Authentifizierung nicht verwendet.

Fügen Sie das Facebook-Login-Produkt hinzu

Befolgen Sie diese Schritte, um die OAuth-Umleitungs-URI zu konfigurieren.

1. Gehen Sie zu Ihren App-Einstellungen und fügen Sie das Facebook-Login-Produkt aus dem Abschnitt „Produkte“ hinzu.

2. Definieren Sie in den Produkteinstellungen die OAuth-Umleitungs-URI.

   Wenn Sie eine Desktop-Anwendung erstellen, setzen Sie die Umleitungs-URI auf https://localhost:33333/, oder eine ähnliche https URL.

   Wenn Sie eine Webanwendung erstellen, legen Sie die Umleitungs-URI fest, die als Rückruf URL verwendet werden soll, zu der die Benutzer mit dem Token zurückkehren, das bestätigt, dass sie Ihrer App Zugriff gewährt haben.

Fügen Sie das Instagram API Produkt hinzu

Befolgen Sie diese Schritte, um die von Ihrer App angeforderten Instagram API Berechtigungen zu konfigurieren:

1. Gehen Sie zu Ihren App-Einstellungen und fügen Sie das Instagram Produkt aus dem Abschnitt „Produkte“ hinzu.

2. Konfigurieren Sie die Berechtigungen in den Produkteinstellungen. Um auf alle Tabellen und Ansichten zuzugreifen, schließen Sie die folgenden Bereiche ein:

   • instagram_basic
   • instagram_comments verwalten
   • instagram_insights_verwalten

   Siehe das Datenmodell finden Sie ausführliche Informationen zu den für bestimmte Tabellen erforderlichen Bereichen.

Senden Sie die App zur Überprüfung, um sie live zu schalten

Sie können zwar immer noch eine Bewerbung ohne Prüfung einreichen, aber um live zu gehen und uneingeschränkt auf Instagram Inhalte zuzugreifen, müssen Sie Ihre Bewerbung zur Prüfung und Genehmigung einreichen.

1. Klicken Sie auf Manage für Ihre Bewerbung und auf der Permissions Tab Start a Submission.
2. Wählen Sie den Anwendungsfall aus, der Ihre Instagram Integration am besten beschreibt.
3. Füllen Sie das Formular aus und warten Sie auf die Genehmigung Ihres Antrags.

Authentifizieren Sie sich bei Instagram

Desktop-Anwendungen

Nachdem Sie die folgenden Verbindungseigenschaften festgelegt haben, können Sie eine Verbindung herstellen:

• OAuthClientId: Legen Sie hier die App-ID für Ihre OAuth-App fest.

• OAuthClientSecret: Legen Sie dies auf das App-Geheimnis für Ihre OAuth-App fest.

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.

• BusinessAccountId: Wenn Sie mehr als eine Facebook-Seite mit einem Instagram-Konto verknüpft haben, legen Sie die BusinessAccountId Verbindungseigenschaft zum Angeben der ID eines Geschäftskontos, das Sie mit einer Facebook-Seite verknüpft haben.

  Sie können eine Geschäftskonto-ID erhalten, indem Sie die Seitenansicht abfragen.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Anschließend schließt der Connector den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Webanwendungen

Befolgen Sie die nachstehenden Schritte, um mit dem Connector die OAuth-Tokenwerte abzurufen und eine Verbindung von einer Webanwendung aus herzustellen. Get an Access Token

Legen Sie die folgenden Verbindungseigenschaften fest, um die OAuthAccessToken:

• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die App-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das App-Geheimnis fest.

Befolgen Sie dann diese Schritte, um den OAuth-Austausch abzuschließen:

1. Rufen Sie GetOAuthAuthorizationURL auf gespeicherte Prozedur. Setzen Sie den AuthMode-Eingang auf WEB und den CallbackURL-Eingang auf die OAuth-Umleitungs-URI, die Sie in Ihren App-Einstellungen angegeben haben. Die gespeicherte Prozedur gibt die URL an den OAuth-Endpoint zurück.

2. Melden Sie sich an und autorisieren Sie die Anwendung. Sie werden zurück zur Rückruf-URL geleitet.

   Die Rückruf URL enthält den Prüfcode in einem Abfrage. Extrahieren Sie den Prüfcode aus der Rückruf URL.

3. Setzen Sie die folgenden Parameter und rufen Sie GetOAuthAccessToken auf: | | | |-------------|------------------------------- ---------------------| | | | | Name | Wert | | Auth-Modus | WEB | | Verifier | Setzen Sie dies auf den Verifier-Code. | | Callback-URL | Legen Sie dies in Ihren App-Einstellungen auf die Rückruf URL fest. |

Mit Daten verbinden

Um Anfragen an Instagram zu stellen, setzen Sie das OAuthAccessToken Eigentum. Die OAuthAccessToken hat eine begrenzte Lebensdauer. Wenn das Token abläuft, müssen Sie die vorangegangenen gespeicherten Prozeduren aufrufen, um eine erneute Authentifizierung durchzuführen.

Mit mehreren Seiten verbinden

Wenn Sie mehr als eine Facebook-Seite mit einem Instagram Geschäftskonto verknüpft haben, legen Sie fest BusinessAccountId zusätzlich zu OAuthAccessToken. Der BusinessAccountId Eigenschaft gibt die ID eines Geschäftskontos an, das Sie mit einer Facebook-Seite verknüpft haben.

Sie können eine Geschäftskonto-ID erhalten, indem Sie die Seitenansicht abfragen.

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 Instagram 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 mithilfe der Privater Agent Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Instagram und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Instagram 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 Users 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 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 Instagram Konnektor modelliert Entitäten in der Instagram API als Tabellen, Ansichten und Gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt.

Programmgesteuertes Entdecken der Schemata

Die verfügbaren Systemtabellen bieten programmgesteuerten Zugriff auf Schema sowie andere Connector-Metadaten, wie etwa die Abfragefunktionen der Datenquelle.

Tabellen

Der Connector modelliert die Daten in Instagram als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Instagram Connector-Tabellen

Kommentare

Kommentare zu einem Medienobjekt erstellen, löschen und Abfrage. Erfordert die Bereiche instagram_basic und instagram_manage_comments.

Es werden nur die Vorgänge „Auswählen“, „Löschen“ und „Einfügen“ unterstützt.

Wählen

Der Connector verwendet die Instagram APIs, um die Ergebnisse nach MediaId zu filtern, und führt weitere Filter clientseitig in sich selbst aus.

• Die folgende Abfrage gibt alle Kommentare zu allen Medien in Ihrem Konto zurück. Die Benutzer-ID ist null, wenn der Kommentar von einem Konto stammt, das kein Geschäftskonto ist.

  SELECT * FROM Comments
  

• Um Kommentare für ein bestimmtes Medienobjekt Abfrage, ist MediaId erforderlich. Die MediaId-Spalte unterstützt den Operator =. Beispiel:

  SELECT * FROM Comments WHERE MediaId = '1501471279105199430_5380790872'
  

Einfügen

Erstellen Sie einen Kommentar zu einem Medienobjekt mit den folgenden Regeln:

• MediaId und Text sind die einzigen verfügbaren und erforderlichen Felder.
• Die Gesamtlänge des Kommentars darf 300 Zeichen nicht überschreiten.
• Der Kommentar darf nicht mehr als 4 Hashtags enthalten.
• Der Kommentar darf nicht mehr als 1 URL enthalten.
• Der Kommentar darf nicht ausschließlich aus Großbuchstaben bestehen.

Zum Beispiel:

INSERT INTO Comments (MediaId, Text) VALUES ('1501471279105199430_5380790872', 'My comment text #instadevelopers')

Aktualisieren

UPDATE wird nicht unterstützt.

Löschen

Die ID (der Primärschlüssel des Kommentars) ist erforderlich. Die folgende Abfrage entfernt beispielsweise einen Kommentar, der sich entweder im Medienobjekt des authentifizierten Benutzers befindet oder vom authentifizierten Benutzer verfasst wurde.

DELETE FROM Comments WHERE ID = '1668776136772254'

Spalten

Antworten

Antworten auf ein Medienobjekt abfragen und einfügen. Erfordert die Bereiche instagram_basic und instagram_manage_comments.

Es werden nur die Operationen „Auswählen“ und „Einfügen“ unterstützt.

Wählen

Der Connector verarbeitet einen Filter auf der CommentId-Serverseite und führt andere Filter auf der Clientseite in sich selbst aus.

• Die folgende Abfrage gibt Antworten auf alle Kommentare in Ihrem Konto zurück. Die Benutzer-ID ist null, wenn die Antwort von einem Konto stammt, das kein Geschäftskonto ist.

  SELECT * FROM Replies
  

• Um Antworten für einen bestimmten Kommentar Abfrage, ist CommentId erforderlich. Der unterstützte Operator für die Spalte CommentId ist =. Beispiel:

  SELECT * FROM Replies WHERE CommentId = '1501471279105199430_5380790872'
  

Einfügen

Erstellen Sie eine Antwort auf ein Kommentarobjekt mit den folgenden Regeln:

• CommentId und Text sind die einzigen verfügbaren und erforderlichen Felder.
• Die Gesamtlänge des Kommentars darf 300 Zeichen nicht überschreiten.
• Die Antwort darf nicht mehr als 4 Hashtags enthalten.
• Die Antwort darf nicht mehr als eine URL enthalten.
• Die Antwort darf nicht ausschließlich aus Großbuchstaben bestehen.

Zum Beispiel:

INSERT INTO Replies (CommentId, Text) VALUES ('1501471279105199430_5380790872', 'My reply #instadevelopers')

Aktualisieren

UPDATE wird nicht unterstützt.

Löschen

Löschen wird nicht unterstützt.

Spalten

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.

Instagram Connector-Ansichten

KontoKontaktButtonTyp

Es gibt die Anzahl der Klicks auf die Schaltflächen „RICHTUNG“, „ANRUFE“ und „E-MAILS“ während des ausgewählten Zeitraums zurück. Für diese Ansicht ist der Metriktyp „total_value“ und die Aufschlüsselung (Dimension) ist „contact_button_type“. Erfordert die Bereiche „instagram_basic“ und „instagram_manage_insights“.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die = Operator.

Die Abfrage gibt Ergebnisse für die Metrik „profile_links_taps“ zurück.

SELECT * FROM AccountContactButtonType
SELECT * FROM AccountContactButtonType WHERE FromDateTime='2023-07-02T00:00:00Z' AND ToDateTime='2023-07-24T00:00:00Z'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KontoFollowerNicht-Follower

Die Anzahl der Konten, die während des ausgewählten Zeitraums gefolgt sind, und die Anzahl der Konten, die Instagram nicht mehr gefolgt sind oder die Nutzung von Instagram eingestellt haben. Für diese Ansicht ist der Metriktyp „total_value“ und „Breakdown(dimension)“ ist „follow_type“. Erfordert die Bereiche „instagram_basic“ und „instagram_manage_insights“.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die =, Und IN Betreiber.

Die Abfrage gibt Ergebnisse für die Metrik „follows_and_unfollows“ zurück.

SELECT * FROM AccountFollowersNonfollowers
SELECT * FROM AccountFollowersNonfollowers WHERE FromDateTime='2023-06-20T00:00:00Z' AND ToDateTime='2023-07-12T00:00:00Z'

Um das Ergebnis für andere Metriken abzurufen, geben Sie die Metrik explizit in der Where-Klausel an. Beispiel:

SELECT * FROM AccountFollowersNonfollowers WHERE Metric = 'reach'
SELECT * FROM AccountFollowersNonfollowers WHERE Metric IN ('follows_and_unfollows', 'reach')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kontoeinblicke

Ermöglicht Ihnen, Einblicke für ein Instagram Geschäftskonto zu erhalten. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Sie können die folgenden Metriken anhand eines Datumsbereichs Abfrage. Der Standarddatumsbereich umfasst die letzten 7 Tage.

• Impressionen (akzeptiert Zeiträume von Tag, Woche und Tagen_28)
• Reichweite (akzeptiert Zeiträume von Tag, Woche und Tagen_28)
• FollowerCount (akzeptiert nur den Tageszeitraum)
• EmailContacts (akzeptiert nur den Tageszeitraum)
• PhoneCallClicks (akzeptiert nur den Tageszeitraum)
• TextMessageClicks (akzeptiert nur den Tageszeitraum)
• GetDirectionsClicks (akzeptiert nur den Tageszeitraum)
• WebsiteClicks (akzeptiert nur den Tageszeitraum)
• ProfileViews (akzeptiert nur den Tageszeitraum)

Geben Sie mit den Spalten FromDateTime und ToDateTime einen Datumsbereich an. Geben Sie die Intervalle des Datumsbereichs an, indem Sie die Spalte Period in der WHERE-Klausel festlegen. Beachten Sie, dass Sie keinen Zeitraum für eine Metrik verwenden können, die dies nicht unterstützt. Sie können beispielsweise Impressions AND FollowerCount nicht mit dem Zeitraum days_28 verwenden, da FollowerCount nur den Zeitraum von Tagen unterstützt.

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine ID beziehen. Der Connector verarbeitet andere Filter clientseitig in sich selbst.

Die folgenden Beispiele zeigen, wie Sie Kennzahlen für einen bestimmten Datumsbereich abrufen:

• Die Abfrage gibt Ergebnisse für die folgenden Kennzahlen der letzten sieben Tage zurück: Impressionen, Reichweite, Followerzahl, E-Mail-Kontakte, Telefonanrufklicks, Textnachrichtenklicks, Klicks auf Wegbeschreibung, Websiteklicks und Profilansichten.

  SELECT * FROM AccountInsights
  

• Filtern Sie nach FromDateTime und ToDateTime, um explizit einen anderen Datumsbereich anzugeben. Der maximale Datumsbereich darf nicht mehr als 30 Tage (2592000 s) betragen.

  SELECT * FROM AccountInsights WHERE FromDateTime = '2018/01/01' AND ToDateTime = '2018/01/30' AND period = 'day'
  

• Ergebnisse über einen Zeitraum von 7 Tagen zurückgeben.

  SELECT * FROM AccountInsights WHERE FromDateTime = '2018/01/01' AND period = 'day'
  

• Ergebnisse vom 01.01.2018 bis 08.01.2018 zurückgeben.

  SELECT * FROM AccountInsights WHERE ToDateTime = '2018/01/08' AND period = 'day'
  

• Gibt eine benutzerdefinierte Projektion von Kontoeinblicken für den Zeitraum vom 01.01.2018 bis 08.01.2018 zurück.

  SELECT Impressions, FollowerCount, EmailContacts FROM AccountInsights WHERE FromDateTime = '2018/01/01' AND ToDateTime = '2018/01/30' AND period = 'day'
  

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KontoMedienProduktTyp

Es gibt die Anzahl der POSTs und IGTVs während des ausgewählten Zeitraums zurück. Für diese Ansicht ist der Metriktyp total_value und Breakdown(dimension) ist media_product_type. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die =, Und IN Betreiber.

Die Abfrage gibt Ergebnisse für die Metrik „Reichweite“ zurück.

SELECT * FROM AccountMediaProductType
SELECT * FROM AccountMediaProductType WHERE FromDateTime='2023-06-20T00:00:00Z' AND ToDateTime='2023-07-12T00:00:00Z'

Um das Ergebnis für eine andere verfügbare Metrik abzurufen, geben Sie die Metrik explizit in der Where-Klausel an. Beispiel:

SELECT * FROM AccountMediaProductType WHERE Metric = 'total_interactions'
SELECT * FROM AccountMediaProductType WHERE Metric = 'likes'
SELECT * FROM AccountMediaProductType WHERE Metric = 'comments'
SELECT * FROM AccountMediaProductType WHERE Metric = 'saves'
SELECT * FROM AccountMediaProductType WHERE Metric = 'shares'
SELECT * FROM AccountMediaProductType WHERE Metric IN ('total_interactions', 'likes', 'comments', 'saves', 'shares')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KontoZeitreihenFollowType

Es gibt die Endzeit und den Wert der Metrik zurück. Für diese Ansicht ist der Metriktyp „time_series“ und die Aufschlüsselung „follow_type“. Erfordert die Bereiche „instagram_basic“ und „instagram_manage_insights“.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die = Operator.

Die Abfrage gibt Ergebnisse für die Metrik „Reichweite“ zurück.

SELECT * FROM AccountTimeSeriesFollowType
SELECT * FROM AccountTimeSeriesFollowType WHERE FromDateTime='2023-06-20T00:00:00Z' AND ToDateTime='2023-07-12T00:00:00Z'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KontoZeitreihenMedienProdukttyp

Es gibt die Endzeit und den Wert der Metrik zurück. Für diese Ansicht ist der Metriktyp „time_series“ und die Aufschlüsselung „media_product_type“. Erfordert die Bereiche „instagram_basic“ und „instagram_manage_insights“.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die = Operator.

Die Abfrage gibt Ergebnisse für die Metrik „Reichweite“ zurück.

SELECT * FROM AccountTimeSeriesMediaProductType
SELECT * FROM AccountTimeSeriesMediaProductType WHERE FromDateTime='2023-06-20T00:00:00Z' AND ToDateTime='2023-07-12T00:00:00Z'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KontoZeitreihenOhneAufschlüsselung

Es gibt die Endzeit und den Wert der Metrik zurück. Für diese Ansicht ist der Metriktyp time_series. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die = Operator.

Die Abfrage gibt Ergebnisse für die Metrik „Impressionen“ zurück.

SELECT * FROM AccountTimeSeriesWithoutBreakdown
SELECT * FROM AccountTimeSeriesWithoutBreakdown WHERE FromDateTime='2023-06-20T00:00:00Z' AND ToDateTime='2023-07-12T00:00:00Z'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Konto ohne Aufschlüsselung

Es gibt die Gesamtwerte des Metriktyps in Instagram zurück. Wenn der Metriktyp beispielsweise „Impressionen“ ist, gibt es die Anzahl der Vorkommen Ihrer Posts, Stories, Reels, Videos und Live-Videos auf dem Bildschirm zurück, einschließlich in Anzeigen. Für diese Ansicht ist der Metriktyp „total_value“. Erfordert die Bereiche „instagram_basic“ und „instagram_manage_insights“.

Wählen

Der Connector verwendet die Instagram APIs, um Filter zu verarbeiten, die sich auf einen Datumsbereich oder eine InstagramBusinessAccountId beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Metric unterstützt die =, Und IN Betreiber.

Die Abfrage gibt Ergebnisse für die Metrik „Impressionen“ zurück.

SELECT * FROM AccountWithoutBreakdown
SELECT * FROM AccountWithoutBreakdown WHERE FromDateTime='2023-06-20T00:00:00Z' AND ToDateTime='2023-07-12T00:00:00Z'

Um das Ergebnis für eine andere verfügbare Metrik abzurufen, geben Sie die Metrik explizit in der Where-Klausel an. Beispiel:

SELECT * FROM AccountWithoutBreakdown WHERE Metric = 'accounts_engaged'
SELECT * FROM AccountWithoutBreakdown WHERE Metric = 'replies'
SELECT * FROM AccountWithoutBreakdown WHERE Metric = 'website_clicks'
SELECT * FROM AccountWithoutBreakdown WHERE Metric = 'profile_views'
SELECT * FROM AccountWithoutBreakdown WHERE Metric IN ('accounts_engaged', 'replies', 'website_clicks', 'profile_views')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Zielgruppeneinblicke

Rufen Sie Follower-Insights für ein Instagram Geschäftskonto ab.

Wählen

Standardmäßig gibt diese Tabelle Folgendes zurück:

• Die Länder, aus denen die Follower dieses Profils stammen.

Um die folgenden demografischen Informationen über Ihre Follower zurückzugeben:

• Die Geschlechts- und Altersverteilung der Follower dieses Profils.

• Die Standorte der Follower dieses Profils nach Ländercode.

• Die Städte der Follower dieses Profils.

Sie müssen nach der Spalte „AudienceType“ filtern:

SELECT * FROM AudienceInsights WHERE AudienceType='country'

SELECT * FROM AudienceInsights WHERE AudienceType IN ('city','country','genderandage')

Die obige Abfrage gibt die Anzahl der Follower aufgeschlüsselt nach Stadt, die Anzahl der Follower aufgeschlüsselt nach Land und die Anzahl der Follower aufgeschlüsselt nach Geschlecht und Alter zurück.

Gültige Werte für die Spalte „AudienceType“ sind:

• Stadt
• Land
• Geschlecht
• Alter
• Geschlecht und Alter

Spalten

IGMedia

Diese Ansicht stellt ein Instagram Foto, -Video, eine-Story, ein-Album oder IGTV-Medium dar.

Wählen

Der Connector verwendet die Instagram API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt die = Operator.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM IGMedia WHERE ID = '1234'

Spalten

InstagramGeschäftProfil

Erhalten Sie Informationen zum Instagram Business-Konto. Erfordert den Bereich instagram_basic, business_management, manage_pages.

Wählen

Der Connector verarbeitet alle Filter dieser Tabelle clientseitig in sich selbst.

Spalten

InstagramSeiten

Abfrage von Informationen zu Seiten, die mit dem Facebook-Konto verknüpft sind. Erfordert den Umfang instagram_basic.

Wählen

Der Connector verarbeitet alle Filter clientseitig in sich selbst. Sie können diese Tabelle verwenden, um den Wert von abzurufen BusinessAccountId Verbindungseigenschaft:

SELECT Name, InstagramBusinessAccountId FROM Pages

Spalten

Medien

Medienobjekte abfragen. Erfordert die Bereiche instagram_basic und instagram_content_publish.

Wählen

Der Connector verwendet die Instagram APIs, um Filter nach ID zu verarbeiten, und verarbeitet andere Filter clientseitig in sich selbst.

Die folgende Abfrage ruft alle vom authentifizierten Benutzer veröffentlichten Medien ab:

SELECT * FROM Media

Zum Abrufen eines einzelnen Medienobjekts ist die ID erforderlich. Die ID-Spalte unterstützt den Operator =. Beispiel:

SELECT * FROM Media WHERE ID = '1501471279105199430_5380790872'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

MediaInsightReels

Ermöglicht Ihnen, Einblicke in Reel-Media-Objekte zu erhalten. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Mithilfe der serverseitigen Verarbeitung können Sie die folgenden Kennzahlen Abfrage:

• Erreichen
• Kommentare
• Gefällt mir
• Gespeichert
• Theaterstücke
• Aktien
• Gesamtinteraktionen

Der Connector verwendet die Instagram APIs, um Filter nach einer MediaId zu verarbeiten, und verarbeitet Filter nach anderen Spalten clientseitig in sich selbst.

• MediaInsightReels gibt nur das Ergebnis des Reels-Objekts zurück.

• Gibt Ergebnisse für die folgenden Metriken zurück, die für alle Reels-Objekte gespeichert wurden: Reichweite, Gespeichert, Kommentare, Likes, Wiedergaben, Shares und Gesamtinteraktionen.

       SELECT * FROM MediaInsightReels WHERE MediaId = 17905513811523370"
  
       SELECT Reach, Saved, Comments, Likes, Plays, Shares, TotalInteractions FROM MediaInsightReels WHERE MediaId = 17905513811523370
  

Spalten

MedienInsights

Ermöglicht Ihnen, Einblicke in ein einzelnes Medienobjekt zu erhalten. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Mithilfe der serverseitigen Verarbeitung können Sie die folgenden Kennzahlen Abfrage:

• Impressionen
• Engagement (Likes, Kommentare und Speicherungen, nur bei Version < 18.0)
• Gesamtzahl der Interaktionen (Likes, Kommentare, Shares und Speicherungen, nur bei Version >= 18.0)
• Erreichen
• Gespeichert
• Videoansichten (nur bei einem Videoobjekt)
• Antworten (nur auf ein Story-Objekt)

Der Connector verwendet die Instagram APIs, um Filter nach einer MediaId zu verarbeiten, und verarbeitet Filter nach anderen Spalten clientseitig in sich selbst.

• MediaInsights gibt Ergebnisse aller Medienobjekte außer Reels-Objekten zurück.

• Gibt Ergebnisse für die folgenden Metriken zurück, die für alle Bild- und Karussellobjekte gespeichert sind: Impressionen, Engagement und Reichweite.

  SELECT * FROM MediaInsights
  

• Abfrage der MediaInsights-Ansicht mit einem anderen Objekt, z. B. Videos.

  SELECT Impressions, Engagement, Reach, Saved, VideoViews FROM MediaInsights WHERE MediaId = "1321555648546465"
  

Spalten

MediaInsightsPost

Ermöglicht Ihnen, Einblicke in ein einzelnes Medienobjekt für Bild- und Video-POSTs zu erhalten. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Mithilfe der serverseitigen Verarbeitung können Sie die folgenden Kennzahlen Abfrage:

• Kommentare
• Folgt
• Gefällt mir
• Profilaktivität
• Profilbesuche
• Aktien
• Gesamtinteraktionen

Der Connector verwendet die Instagram APIs, um Filter nach einer MediaId zu verarbeiten, und verarbeitet Filter nach anderen Spalten clientseitig in sich selbst.

• Gibt Ergebnisse für die folgenden Metriken zurück, die für alle Bild- und Videoobjekte der POSTs gespeichert sind: Kommentare, Follows, Likes, Profilaktivität, Profilbesuche, Shares und Gesamtinteraktionen.

       SELECT * FROM MediaInsightsPost WHERE MediaId = 17945732813652602"
  
       SELECT Comments, Follows, Likes, ProfileActivity, ProfileVisits, Shares, TotalInteractions FROM MediaInsightsPost WHERE MediaId = 17945732813652602
  

Spalten

MediaInsightsPostAlbum

Ermöglicht Ihnen, Einblicke in ein einzelnes Medienobjekt für Karussellalbum-POSTs zu erhalten. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Mithilfe der serverseitigen Verarbeitung können Sie die folgenden Kennzahlen Abfrage:

• Gesamtinteraktionen

Der Connector verwendet die Instagram APIs, um Filter nach einer MediaId zu verarbeiten, und verarbeitet Filter nach anderen Spalten clientseitig in sich selbst.

• Gibt Ergebnisse für die folgenden Metriken zurück, die für alle POST-Karussellalbumobjekte gespeichert wurden: TotalInteractions.

       SELECT * FROM MediaInsightsPostAlbum WHERE MediaId = 17945732813652602"
  
       SELECT TotalInteractions FROM MediaInsightsPostAlbum WHERE MediaId = 17945732813652602
  

Spalten

MedienEinblickeGeschichte

Ermöglicht Ihnen, Einblicke in ein einzelnes Medienobjekt für Story zu erhalten. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Mithilfe der serverseitigen Verarbeitung können Sie die folgenden Kennzahlen Abfrage:

• Folgt
• Profilaktivität
• Profilbesuche
• Aktien
• Gesamtinteraktionen
• TapsForward (nur bei Version < 18.0)
• TapsBack (nur bei Version < 18.0)
• Beenden (nur bei Version < 18.0)
• Navigation (nur bei Version >= 18.0)

Der Connector verwendet die Instagram APIs, um Filter nach einer Medien-ID zu verarbeiten, und verarbeitet Filter nach anderen Spalten clientseitig in sich selbst. Bitte beachten Sie, dass Insights und Metriken im Zusammenhang mit Stories aufgrund der Art von Stories auf Instagram nach 24 Stunden ablaufen.

• Gibt Ergebnisse für die folgenden Metriken zurück, die für alle Story-Objekte gespeichert wurden: Follows, ProfileActivity, ProfileVisits, Shares und TotalInteractions.

       SELECT * FROM MediaInsightsStory WHERE MediaId = 17945732813652602"
  
       SELECT Comments, Follows, Likes, ProfileActivity, ProfileVisits, Shares, TotalInteractions FROM MediaInsightsStory WHERE MediaId = 17945732813652602
  

Spalten

OnlineFollowers

Frage Online-Follower-Insights als stündliche Gesamtwerte ab. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Sie können die Spalten FromDateTime und ToDateTime verwenden, um die Ergebnisse nach einem Zeitrahmen zu filtern. Der Connector verwendet die Instagram API, um Filter zu verarbeiten, die sich auf einen Zeitrahmen oder eine ID beziehen, und verarbeitet andere Filter clientseitig in sich selbst.

• Die Abfrage gibt die Ergebnisse als Stundensummen der letzten 7 Tage zurück.

  SELECT * FROM OnlineFollowers
  

• Der maximale Zeitrahmen, den Sie mit den Spalten FromDateTime und ToDateTime angeben können, beträgt 30 Tage (2592000 s).

  SELECT * FROM OnlineFollowers WHERE FromDateTime = '2018/01/01' AND ToDateTime = '2018/01/30'
  

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Seiten

Details zu Seiten abrufen. Erfordert eine benutzerdefinierte OAuth-App mit der Berechtigung „pages_read_engagement“ oder die Funktion „Öffentlicher Seiteninhaltszugriff“ oder „Öffentlicher Seitenmetadatenzugriff“.

Tabellenspezifische Informationen

Wählen

Informationen zum Erstellen einer benutzerdefinierten OAuth-App finden Sie unter Erstellen einer benutzerdefinierten OAuth-App. Informationen zum Abrufen der erforderlichen Berechtigungen dieser Ansicht für eine benutzerdefinierte OAuth-App finden Sie in der neuesten Dokumentation von Instagram.

Der Connector verwendet die Instagram API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die Suchbegriffe sind erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• SearchTerms unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM Pages WHERE SearchTerms = 'facebook'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Berechtigungen

Fragen Sie die Berechtigungen ab, die der Benutzer der aktuellen Anwendung erteilt hat.

Wählen

Um die Berechtigungsansicht Abfrage.

SELECT * FROM Permissions

Spalten

Geschichten

Storys abfragen. Erfordert die Bereiche instagram_basic und instagram_manage_insights.

Wählen

Der Connector verarbeitet alle Filter dieser Tabelle clientseitig in sich selbst.

Spalten

Schlagwörter

Abfrage-Tags. Erfordert die Bereiche instagram_basic und instagram_manage_comments.

Wählen

Der Connector verarbeitet alle Filter dieser Tabelle clientseitig in sich selbst.

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Instagram hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Instagram zurück, zusammen mit einem Hinweis, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Gespeicherte Prozeduren für den Instagram Connector

GetOAuthAccessToken

Ruft den OAuth-Zugriffstoken von Instagram ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs-URL für Instagram ab. Greifen Sie in einem Webbrowser auf die in der Ausgabe zurückgegebene URL zu. Dadurch wird das Zugriffstoken angefordert, das als Teil der Verbindungszeichenfolge für Instagram verwendet werden kann.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert das OAuth-Token.

Eingang

Ergebnissatzspalten

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 Instagram zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Benutzer“ zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Users'

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Merge-Prozedur zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='Merge' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Tabelle „Benutzer“ ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Users'

Spalten

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

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

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

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:instagram: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

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.

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

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

Systeminformationen

Beschreibt die verfügbaren Systeminformationen.

Die folgende Abfrage ruft alle Spalten ab:

SELECT * FROM sys_information

Spalten

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

OAuth

SSL

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

Geschäftskonto-ID

Die ID eines verknüpften Instagram-Geschäftskontos.

Datentyp

string

Standardwert

""

Hinweise

Die ID eines Instagram-Geschäftskontos, das mit einer Facebook-Seite verknüpft ist. Legen Sie dies nur fest, wenn Sie mehrere Instagram Geschäftskonten haben, die mit demselben Facebook-Konto verwaltet werden.

Version

Die zu verwendende Facebook Graph API Version.

Datentyp

string

Standardwert

19.0

Hinweise

Die zu verwendende Facebook Graph API Version. Im Allgemeinen muss diese Eigenschaft nicht festgelegt werden.

AuthenticateAsPage

„true“ oder „false“ zur Authentifizierung für den Seitenzugriffstoken, wie bei Anfragen an Instagram.

Datentyp

bool

Standardwert

false

Hinweise

true oder false zur Authentifizierung für den Seitenzugriffstoken. Die Seite muss vom authentifizierten Benutzer verwaltet werden.

OAuth

Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.

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

OFF, GETANDREFRESH, REFRESH

Datentyp

string

Standardwert

OFF

Hinweise

Folgende Optionen stehen zur Verfügung:

1. OFF: Gibt an, dass der OAuth-Flow vollständig vom Benutzer gehandhabt wird. Zur Authentifizierung ist ein OAuthAccessToken erforderlich.
2. GETANDREFRESH: Gibt an, dass der gesamte OAuth-Flow vom Connector verarbeitet wird. Wenn derzeit kein Token vorhanden ist, wird es durch eine entsprechende Aufforderung an den Benutzer über den Browser abgerufen. Wenn ein Token vorhanden ist, wird es bei Bedarf aktualisiert.
3. REFRESH: Gibt an, dass der Connector nur das Aktualisieren des OAuthAccessToken übernimmt. Der Benutzer wird vom Connector nie aufgefordert, sich über den Browser zu authentifizieren. Der Benutzer muss zunächst das Abrufen des OAuthAccessToken und des OAuthRefreshToken übernehmen.

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 die OAuthClientId, auch Consumer-Schlüssel genannt. Sie erhalten außerdem ein Client-Geheimnis, auch Consumer-Geheimnis genannt. Legen Sie das Client-Geheimnis im OAuthClientSecret Eigentum.

OAuth-Zugriffstoken

Der Zugriffstoken für die Verbindung per OAuth.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthAccessToken Eigenschaft wird für die Verbindung per 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.

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 halten, indem Sie einen Wert angeben, der mit beginnt 'memory://'.

Datentyp

string

Standardwert

%APPDATA%\Instagram Data Provider\OAuthSettings.txt

Hinweise

Wenn InitiateOAuth ist auf gesetzt GETANDREFRESH oder REFRESH, der Connector 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 den Speicher verwenden. Speicherorte werden durch einen Wert angegeben, der mit beginnt '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 die 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%\ Instagram Data Provider\OAuthSettings.txt“ mit %APPDATA% auf das Konfigurationsverzeichnis des Benutzers gesetzt. Die Standardwerte sind

• Windows: "register://%DSN"
• Unix: "%AppData%..."
• Mac: "%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:

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.

SSL

Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.

SSLServerCert

Das vom Server zu akzeptierende Zertifikat bei einer Verbindung über 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:

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.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\Instagram 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 Die Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen (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%\ Instagram Data Provider\Schema“ mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

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.

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

Seitengröße

Die maximale Anzahl der Ergebnisse, die pro Seite von Instagram zurückgegeben werden sollen.

Datentyp

int

Standardwert

0

Hinweise

Der Pagesize Die Eigenschaft beeinflusst die maximale Anzahl von Ergebnissen, die pro Seite von Instagram zurückgegeben werden. Das Festlegen eines höheren Wertes kann zu einer besseren Leistung führen, allerdings auf Kosten des zusätzlichen Speichers, der pro verbrauchter Seite zugewiesen wird.

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 Users WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die 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.