Microsoft Azure Table Storage Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

Versionsunterstützung für Azure Table Storage

Herstellen einer Verbindung

Herstellen einer Verbindung mit Azure Table Storage-APIs

Der Treiber stellt eine Verbindung mit dem durch angegebenen Azure Table Storage-Konto her Account. Standardmäßig werden Verbindungen zum Azure Table Storage über SSL gesichert, dies kann jedoch über gesteuert werden UseSSL. Die Authentifizierungsmethode für den Azure Table Storage wird bestimmt durch AuthScheme Eigentum.

Authentifizieren bei Azure Table Storage

Zur Authentifizierung können folgende Mechanismen verwendet werden.

Authentifizierung mit Access Key

Satz Account zum Speicherkontonamen und legen Sie die AccessKey des Speicherkontos, mit dem eine Verbindung hergestellt werden soll. Befolgen Sie die nachstehenden Schritte, um diese Werte zu erhalten:

Wenn Sie Storage als verwenden Backend (Standard):

1. Melden Sie sich beim Azure-Portal an und wählen Sie im Dienstemenü links „Speicherkonten“ aus.
2. Wenn Sie derzeit keine Speicherkonten haben, erstellen Sie eines, indem Sie auf die Schaltfläche „Hinzufügen“ klicken.
3. Klicken Sie auf den Link für das Speicherkonto, das Sie verwenden möchten, und wählen Sie unter „Einstellungen“ die Option „Zugriffsschlüssel“ aus. Das Fenster „Zugriffsschlüssel“ enthält den Namen und den Schlüssel des Speicherkontos (Sie können entweder „key1“ oder „key2“ zum Herstellen einer Verbindung verwenden), die Sie im Connector verwenden müssen. Diese Eigenschaften entsprechen den Account Und AccessKey Connector-Verbindungseigenschaften bzw.

Bei Verwendung von CosmosDB als Backend:

1. Melden Sie sich beim Azure-Portal an und wählen Sie Cosmos DB im Dienstemenü auf der linken Seite aus.
2. Klicken Sie auf den Link für das Cosmos DB-Konto, das Sie verwenden möchten, und wählen Sie unter „Einstellungen“ die Option „Verbindungszeichenfolge“ aus. Das Fenster „Verbindungszeichenfolge“ enthält den Namen des Cosmos DB-Kontos und den Primärschlüssel, die Sie im Connector verwenden müssen. Diese Eigenschaften entsprechen den Account Und AccessKey Verbindungseigenschaften des Konnektors bzw.

Authentifizieren mit Shared Access Signature

Satz Account zum Speicherkontonamen und legen Sie die SharedAccessSignature zu einer gültigen Signatur einer Ressource, mit der eine Verbindung hergestellt werden soll. Die SharedAccessSignature kann mit einem Tool wie Azure Storage Explorer generiert werden.

Normalerweise wenn SharedAccessSignature verwendet wird, muss die konkrete Tabelle, mit der gearbeitet werden soll, auch über angegeben werden Tables Verbindungseigenschaft. Wenn keine Tabelle angegeben ist, wird versucht, die Tabelle aufzulisten. Dies kann jedoch aufgrund fehlender Berechtigungen fehlschlagen.

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 Azure Table Storage-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.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Azure Table Storage 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 NorthwindProducts 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"

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 ermöglicht Ihnen den Zugriff auf Daten im Azure Table Storage über eine standardmäßige datenbankähnliche Schnittstelle. Azure-Tabellen sind hochgradig skalierbare NoSQL-Clouddatenbanken, die sich stark von einer regulären Datenbank unterscheiden. In diesem Abschnitt beschreiben wir, wie wir schemalose Azure-Tabellen als reguläre Tabellen modellieren. Siehe Tabellen, Tabellenspalten und Gespeicherte Prozeduren.

Tabellen

Die Liste der Tabellen wird dynamisch aus Ihrem Azure-Konto abgerufen, sodass alle Hinzufügungen oder Löschungen sofort angezeigt werden, wenn Sie eine Verbindung mit dem Connector herstellen. Sie können die Funktion CreateTable verwenden gespeicherte Prozedur zum Erstellen einer neuen Tabelle.

Azure-Tabellen erfordern sowohl einen Partitionsschlüssel als auch einen Zeilenschlüssel. Beide müssen für alle Abfragen außer SELECT-Abfragen festgelegt werden.

Tabellenspalten

Da Azure Table Storage-Tabellen schemalos sind, bietet der Connector die folgenden zwei Mechanismen zum Aufdecken des Schema.

Dynamische Schemas

Die Spalten einer Tabelle werden dynamisch bestimmt, indem die Daten in den ersten Zeilen gescannt werden. Sie können die Anzahl der verwendeten Zeilen anpassen, indem Sie ändern RowScanDepth Eigentum. Wann TypeDetectionScheme auf „RowScan“ eingestellt ist, bestimmt der Zeilenscan auch den Datentyp. Die folgende Tabelle zeigt, wie die verschiedenen von Azure Table Storage unterstützten Datentypen im Connector modelliert werden.

Statische Schemas

Anstatt dynamisch ermittelte Schemata zu verwenden, können Sie Ihre eigenen Schemata definieren. Dadurch erhalten Sie mehr Kontrolle über die projizierten Spalten und können Datentypen auch manuell definieren. Verwenden Sie das im Connector enthaltene Schema, um Ihr eigenes Schema zu definieren. Sie können einfach den Namen der Schema ändern, der mit dem Namen der Azure Table Storage-Tabelle übereinstimmen muss, und die Spaltenliste bearbeiten, um sie für Ihre eigene Tabelle zu verwenden.

Schemalose Operationen

Das Schema der Tabelle ist zum Abrufen von Daten erforderlich, unabhängig davon, ob Sie es manuell definieren oder dynamisch abrufen. Allerdings können Daten in Spalten eingefügt, aktualisiert oder gelöscht werden, die im Schema nicht vorhanden sind. Für Spalten, die noch nicht im Schema vorhanden sind, wird der Datentyp auf „String“ festgelegt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Jitterbit-Connector für gespeicherte Prozeduren im Azure Table Storage

Entity mit Typen erstellen

Erstellt einen neuen Datensatz mit den angegebenen Datentypen. Wenn eine Spalte in einer vorhandenen Entität nicht gefunden wird, müssen Sie dieses Verfahren verwenden, um den Typ der Eigenschaft auf etwas anderes als Zeichenfolge festzulegen.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für die Prozedur.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Geben Sie mehrere Instanzen eines indizierten Parameters wie folgt ein:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Eingang

Ergebnissatzspalten

Schema erstellen

Erstellt eine Schema für die angegebene Tabelle oder Ansicht.

Eingang

Ergebnissatzspalten

Tabelle erstellen

Erstellt eine neue Tabelle im Azure-System.

Eingang

Ergebnissatzspalten

DropTable

Löscht eine vorhandene Tabelle im Azure-System.

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 Azure Table Storage 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 „NorthwindProducts“ zurück:

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

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

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateTable' 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 „NorthwindProducts“ ab:

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

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_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:azuretables: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.

Gemeinsame Abfrageverarbeitung

Wenn Sie mit Datenquellen arbeiten, die SQL-92 nicht unterstützen, können Sie die Ansicht sys_sqlinfo Abfrage, um die Abfrage der zugrunde liegenden APIs in SQL-Syntax zu ermitteln. Der Connector verlagert so viel wie möglich von der Verarbeitung der SELECT-Anweisung auf den Server und verarbeitet den Rest der Abfrage dann im Speicher.

Entdecken der SELECT-Funktionen der Datenquelle

Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Der folgende Ergebnissatz zeigt die SELECT-Funktionalität an, die der Connector auf die Datenquelle oder die Prozessclientseite auslagern kann. Ihre Datenquelle unterstützt möglicherweise zusätzliche SQL-Syntax. 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

Datentypzuordnung

Datentypzuordnungen

Der Connector ordnet Typen aus der Datenquelle dem entsprechenden im Schema verfügbaren Datentyp zu. Die folgende Tabelle dokumentiert diese Zuordnungen.

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

SSL

Schema

Verschiedenes

Authentifizierung

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

Konto

Der Name des Windows Azure Storage-Kontos.

Datentyp

string

Standardwert

""

Hinweise

Der Name des Windows Azure-Speicherkontos. Um auf Ihre Azure-Speicherkonten zuzugreifen oder ein neues zu erstellen, melden Sie sich beim Azure-Portal an. Klicken Sie im Dienstemenü links auf „Speicherkonten“.

Wenn Backend auf AzureStack eingestellt ist, legen Sie das Konto als vollständigen Host für Ihre Daten fest. Beispiel: <account>.nm.azs.sandia.gov.

Wenn Backend auf Emulator eingestellt ist, legen Sie das Konto als vollständigen Host fest. Beispiel: http://127.0.0.1:10002/devstoreaccount1.

Verwenden Sie SSL

Dieses Feld legt fest, ob SSL aktiviert ist. Der Standardwert ist „true“.

Datentyp

bool

Standardwert

true

Hinweise

Dieses Feld legt fest, ob SSL aktiviert ist. Der Standardwert ist „true“.

Zugriffsschlüssel

Der Schlüssel für das Speicherkonto.

Datentyp

string

Standardwert

""

Hinweise

Um den Zugriffsschlüssel zu erhalten, melden Sie sich beim Azure-Portal an und klicken Sie im Menü „Dienste“ links auf „Speicherkonten“, um die Speicherkonten aufzulisten. Wählen Sie ein Speicherkonto aus und klicken Sie im Abschnitt „Einstellungen“ auf „Zugriffsschlüssel“. Es kann entweder „key1“ oder „key2“ verwendet werden.

Bei Verwendung von CosmosDB als Backend, navigieren Sie stattdessen zum Cosmos DB-Dienst und wählen Sie Ihr Azure Cosmos DB Konto aus. Wechseln Sie im Ressourcenmenü zur Seite „Verbindungszeichenfolge“. Suchen Sie den PRIMARY KEY-Wert und legen Sie AccessKey auf diesen Wert fest.

AuthScheme

Das zur Authentifizierung verwendete Schema. Akzeptierte Einträge sind AccessToken und SharedAccessSignature.

Mögliche Werte

AccessToken, SharedAccessSignature

Datentyp

string

Standardwert

SharedAccessSignature

Hinweise

Zusammen mit Account, dieses Feld wird zur Authentifizierung gegenüber dem Dienst verwendet. Der Standardwert ist AccessToken:

• AccessToken: Gibt an, dass die Authentifizierung über AccessKey erfolgt und Konto.
• SharedAccessSignature: Gibt an, dass die Authentifizierung über SharedAccessSignature erfolgt und Konto. Im Allgemeinen Tabellen muss ebenfalls gesetzt sein.

Backend

Das Backend, in dem Daten gespeichert werden.

Mögliche Werte

AzureStack, CosmosDB, Storage, Emulator

Datentyp

string

Standardwert

Storage

Hinweise

Daten können entweder aus dem klassischen Azure Table Storage-Repository, dem Azure Storage Emulator oder aus CosmosDB abgerufen werden. Alternativ können Sie AzureStack angeben, wenn Sie Azure Stack Hub verwenden. Wenn Sie dies tun möchten, geben Sie das Konto an als vollständigen Host für Ihre Daten. Beispiel: <account>.nm.azs.sandia.gov.

Wenn Sie „Emulator“ wählen, geben Sie das Konto und SharedAccessSignature Verbindungseigenschaft.

SharedAccessSignature

Eine gemeinsam genutzte Zugriffsschlüsselsignatur, die zur Authentifizierung verwendet werden kann.

Datentyp

string

Standardwert

""

Hinweise

Eine gemeinsame Zugriffssignatur. Kann anstelle eines AccessKey verwendet werden, um auf Ressourcen zuzugreifen.

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%\AzureTables 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 nicht angegeben, ist der Standardspeicherort „%APPDATA%\AzureTables 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.

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.

Tabellen

Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.

Datentyp

string

Standardwert

""

Hinweise

Bei Verwendung von SharedAccessSignature, im Allgemeinen die Tables sollte gesetzt werden, um anzugeben, für welche Ressource die Signatur bestimmt ist.

Diese Eigenschaft kann auch als Alternative zur automatischen Auflistung 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`.

Verschiedenes

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

Schemadateien generieren

Gibt die Benutzerpräferenz an, wann Schemata generiert und gespeichert werden sollen.

Mögliche Werte

Never, OnUse, OnStart, OnCreate

Datentyp

string

Standardwert

Never

Hinweise

Diese Eigenschaft gibt Schemata in .rsd-Dateien im durch Location angegebenen Pfad aus.

Die folgenden Einstellungen sind verfügbar:

• Niemals: Es wird nie eine Schema generiert.
• OnUse: Beim ersten Verweis auf eine Tabelle wird eine Schema generiert, sofern die Schema für die Tabelle noch nicht vorhanden ist.
• OnStart: Zum Zeitpunkt der Verbindung wird für alle Tabellen, die aktuell keine Schema haben, eine Schema generiert.
• OnCreate: Beim Ausführen einer CREATE TABLE-SQL- Abfrage wird eine Schema generiert.

Beachten Sie, dass Sie eine Datei zuerst löschen müssen, wenn Sie sie neu generieren möchten.

Generieren von Schemas mit SQL

Wenn Sie setzen GenerateSchemaFiles Zu OnUse, der Connector generiert Schemata, während Sie SELECT-Abfragen ausführen. Schemata werden für jede in der Abfrage referenzierte Tabelle generiert.

Wenn Sie setzen GenerateSchemaFiles Zu OnCreate, Schemas werden nur generiert, wenn eine CREATE TABLE Abfrage ausgeführt wird.

Schemas bei Verbindung generieren

Eine andere Möglichkeit, diese Eigenschaft zu verwenden, besteht darin, beim Herstellen einer Verbindung Schemata für jede Tabelle in Ihrer Datenbank abzurufen. Setzen Sie dazu GenerateSchemaFiles Zu OnStart und verbinden.

MaxRows

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden.

Datentyp

int

Standardwert

-1

Hinweise

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden.

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

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. „*=*“.

Zeilenscantiefe

Die maximale Anzahl zu scannender Zeilen, um nach den in einer Tabelle verfügbaren Spalten zu suchen.

Datentyp

int

Standardwert

50

Hinweise

Die Spalten in einer Tabelle müssen durch das Scannen der Tabellenzeilen ermittelt werden. Dieser Wert bestimmt die maximale Anzahl der zu scannenden Zeilen.

Das Festlegen eines hohen Wertes kann die Leistung beeinträchtigen. Das Festlegen eines niedrigen Wertes kann dazu führen, dass der Datentyp nicht richtig ermittelt wird, insbesondere wenn Nulldaten vorhanden sind.

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.

Typerkennungsschema

Bestimmt, wie der Datentyp von Spalten ermittelt wird.

Mögliche Werte

None, RowScan

Datentyp

string

Standardwert

RowScan

Hinweise