Konfigurieren der verwalteten Azure SQL-Instanz in einer Kopieraktivität

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in einer Pipeline verwenden, um Daten aus und in die von Azure SQL verwaltete Instanz zu kopieren.

Unterstützte Konfiguration

Die Konfiguration der einzelnen Registerkarten unter der Copy-Aktivität finden Sie in den folgenden Abschnitten.

• Allgemein
• Quelle
• Ziel
• Abbildung
• Einstellungen

Allgemein

Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen-Anleitung.

Quelle

Die folgenden Eigenschaften werden für azure SQL Managed Instance unter der Registerkarte " Quelle " einer Kopieraktivität unterstützt.

Die folgenden Eigenschaften sind erforderlich:

• Verbindung: Wählen Sie eine Azure SQL Managed Instance-Verbindung aus der Verbindungsliste aus. Wenn die Verbindung nicht vorhanden ist, erstellen Sie eine neue Azure SQL Managed Instance-Verbindung, indem Sie " Neu" auswählen.

• Verbindungstyp: Wählen Sie azure SQL Managed Instance aus.

• Verwenden Sie die Abfrage: Geben Sie die Möglichkeit zum Lesen von Daten an. Sie können "Tabelle", " Abfrage" oder " Gespeicherte Prozedur" auswählen. In der folgenden Liste wird die Konfiguration jeder Einstellung beschrieben:

  • Tabelle: Lesen von Daten aus der angegebenen Tabelle. Wählen Sie ihre Quelltabelle aus der Dropdownliste aus, oder wählen Sie "Bearbeiten" aus, um sie manuell einzugeben.

  • Abfrage: Geben Sie die benutzerdefinierte SQL-Abfrage an, um Daten zu lesen. Beispiel ist select * from MyTable. Oder wählen Sie das Bleistiftsymbol aus, das im Code-Editor bearbeitet werden soll.

    

  • Gespeicherte Prozedur: Verwenden Sie die gespeicherte Prozedur, die Daten aus der Quelltabelle liest. Die letzte SQL-Anweisung muss eine SELECT-Anweisung in der gespeicherten Prozedur sein.

    • Name der gespeicherten Prozedur: Wählen Sie die gespeicherte Prozedur aus, oder geben Sie den Namen der gespeicherten Prozedur manuell an, wenn Sie " Bearbeiten" auswählen, um Daten aus der Quelltabelle zu lesen.

    • Parameter für gespeicherte Prozeduren: Geben Sie Werte für gespeicherte Prozedurparameter an. Zulässige Werte sind Namen oder Name-Wert-Paare. Die Namen und die Groß-/Kleinschreibung von Parametern müssen den Namen und der Groß-/Kleinschreibung der Parameter der gespeicherten Prozedur entsprechen. Sie können "Importparameter" auswählen, um die Parameter der gespeicherten Prozedur abzurufen.

      

Unter "Erweitert" können Sie die folgenden Felder angeben:

• Abfragetimeout (Minuten): Geben Sie das Timeout für die Ausführung des Abfragebefehls an, der Standardwert ist 120 Minuten. Wenn für diese Eigenschaft ein Parameter festgelegt ist, sind zulässige Werte Zeitbereich, z. B. "02:00:00" (120 Minuten).

• Isolationsebene: Gibt das Transaktionssperrverhalten für die SQL-Quelle an. Die zulässigen Werte sind: Read committed, Read uncommitted, Repeatable read, Serializable, Snapshot. Ohne Angabe wird die Standardisolationsstufe der Datenbank verwendet. Weitere Informationen finden Sie unter IsolationLevel Enum .

  

• Partitionsoption: Geben Sie die Datenpartitionierungsoptionen an, die zum Laden von Daten aus der von Azure SQL verwalteten Instanz verwendet werden. Zulässige Werte sind: Keine (Standard), physische Partitionen der Tabelle und dynamischer Bereich. Wenn eine Partitionsoption aktiviert ist (also nicht None), wird der Grad der Parallelität beim gleichzeitigen Laden von Daten aus der Azure SQL Managed Instance durch den Grad der Kopierparallelität auf der Registerkarte "Kopieraktivitätseinstellungen" gesteuert.

  • Keine: Wählen Sie diese Einstellung aus, um keine Partition zu verwenden.

  • Physische Partitionen der Tabelle: Wenn Sie eine physische Partition verwenden, werden die Partitionsspalte und der Mechanismus basierend auf Ihrer physischen Tabellendefinition automatisch bestimmt.

  • Dynamischer Bereich: Wenn Sie die Abfrage mit parallel aktivierter Abfrage verwenden, ist der Bereichspartitionsparameter(?DfDynamicRangePartitionCondition) erforderlich. Beispielabfrage: SELECT * FROM <TableName> WHERE ?DfDynamicRangePartitionCondition.

    • Partitionsspaltenname: Geben Sie den Namen der Quellspalte im Integer- oder Date/Datetime-Typ (int, smallint, bigint, date, smalldatetime, datetime, datetime2 oder datetimeoffset) an, die von der Bereichspartitionierung für parallele Kopie verwendet wird. Wenn nicht angegeben, wird der Index oder der Primärschlüssel der Tabelle automatisch erkannt und als Partitionsspalte verwendet.

      Wenn Sie die Quelldaten mithilfe einer Abfrage abrufen, integrieren Sie ?DfDynamicRangePartitionCondition in die WHERE-Klausel. Ein Beispiel sehen Sie im Abschnitt "Paralleles Kopieren von Azure SQL-Verwaltete Instanz".

    • Partition obere Grenze: Geben Sie den Maximalwert der Partitionsspalte für die Partitionsbereichsteilung an. Dieser Wert wird verwendet, um den Partitionsschritt zu bestimmen, nicht zum Filtern der Zeilen in der Tabelle. Alle Zeilen im Tabellen- oder Abfrageergebnis werden partitioniert und kopiert. Wenn nicht angegeben, wird der Wert für die Kopieraktivität automatisch erkannt. Ein Beispiel sehen Sie im Abschnitt "Paralleles Kopieren von Azure SQL-Verwaltete Instanz".

    • Partition untere Grenze: Geben Sie den Minimalwert der Partitionsspalte für die Partitionsbereichsteilung an. Dieser Wert wird verwendet, um den Partitionsschritt zu bestimmen, nicht zum Filtern der Zeilen in der Tabelle. Alle Zeilen im Tabellen- oder Abfrageergebnis werden partitioniert und kopiert. Wenn nicht angegeben, wird der Wert für die Kopieraktivität automatisch erkannt. Ein Beispiel sehen Sie im Abschnitt "Paralleles Kopieren von Azure SQL-Verwaltete Instanz".

• Zusätzliche Spalten: Fügen Sie zusätzliche Datenspalten hinzu, um den relativen Pfad oder statischen Wert der Quelldateien zu speichern. Für Letzteres wird ein Ausdruck unterstützt.

Beachten Sie die folgenden Punkte:

• Wenn die Abfrage für die Quelle angegeben ist, führt die Kopieraktivität diese Abfrage mit der Azure SQL Managed Instance-Quelle aus, um die Daten abzurufen. Sie können auch eine gespeicherte Prozedur angeben, indem Sie den Namen der gespeicherten Prozedur und gespeicherte Prozedurparameter angeben, wenn die gespeicherte Prozedur Parameter akzeptiert.
• Wenn Sie die gespeicherte Prozedur in der Quelle zum Abrufen von Daten verwenden, beachten Sie, dass bei Übergabe eines anderen Parameterwerts Ihre gespeicherte Prozedur ein anderes Schema zurückgeben kann, wodurch Sie möglicherweise einen Fehler erleben oder unerwartete Ergebnisse sehen, insbesondere beim Importieren des Schemas über die Benutzeroberfläche oder beim Kopieren von Daten in die SQL-Datenbank mit automatischer Tabellenerstellung.

Bestimmungsort

Die folgenden Eigenschaften werden für azure SQL Managed Instance unter der Registerkarte "Ziel " einer Kopieraktivität unterstützt.

Die folgenden Eigenschaften sind erforderlich:

• Verbindung: Wählen Sie eine Azure SQL Managed Instance-Verbindung aus der Verbindungsliste aus. Wenn die Verbindung nicht vorhanden ist, erstellen Sie eine neue Azure SQL Managed Instance-Verbindung, indem Sie " Neu" auswählen.

• Verbindungstyp: Wählen Sie azure SQL Managed Instance aus.

• Tabellenoption: Sie können Vorhandenes verwenden auswählen, um die angegebene Tabelle zu nutzen. Oder wählen Sie die AutoErstellungstabelle aus, um automatisch eine Zieltabelle zu erstellen, wenn die Tabelle nicht im Quellschema vorhanden ist, und beachten Sie, dass diese Auswahl nicht unterstützt wird, wenn die gespeicherte Prozedur als Schreibverhalten verwendet wird.

  Wenn Sie "Vorhandenes verwenden" auswählen:

  • Tabelle: Wählen Sie die Tabelle in Ihrer Zieldatenbank aus der Dropdownliste aus. Sie können auch Bearbeiten aktivieren, um den Tabellennamen manuell einzugeben.

  Wenn Sie folgendes auswählen: Tabelle automatisch erstellen:

  • Tabelle: Geben Sie den Namen für die automatisch erstellte Zieltabelle an.

Unter "Erweitert" können Sie die folgenden Felder angeben:

• Schreibverhalten: Definiert das Schreibverhalten, wenn die Quelle Dateien aus einem dateibasierten Datenspeicher ist. Sie können "Einfügen", "**Upsert" oder " Gespeicherte Prozedur" auswählen.

  • Einfügen: Wählen Sie diese Option aus, um das Einfügeverhalten zum Laden von Daten in Azure SQL Managed Instance zu verwenden.

  • Upsert: Wählen Sie diese Option aus, um das Upsert-Schreibverhalten zum Laden von Daten in azure SQL Managed Instance zu verwenden.

    • Verwenden Sie TempDB: Geben Sie an, ob eine globale temporäre Tabelle oder physische Tabelle als Zwischentabelle für upsert verwendet werden soll. Standardmäßig verwendet der Dienst die globale temporäre Tabelle als Zwischentabelle, und diese Eigenschaft ist ausgewählt.

      

    • Wählen Sie das Benutzer-DB-Schema aus: Wenn " TempDB verwenden " nicht ausgewählt ist, geben Sie das Interimsschema zum Erstellen einer Zwischentabelle an, wenn eine physische Tabelle verwendet wird.

      Hinweis

      Sie müssen über die Berechtigung zum Erstellen und Löschen von Tabellen verfügen. Standardmäßig verwendet eine Zwischentabelle das gleiche Schema wie eine Zieltabelle.

      

    • Schlüsselspalten: Geben Sie die Spaltennamen für die eindeutige Zeilenidentifikation an. Es kann entweder ein einzelner Schlüssel oder eine Reihe von Schlüsseln verwendet werden. Bei fehlender Angabe wird der Primärschlüssel verwendet.

  • Gespeicherte Prozedur: Verwenden Sie die gespeicherte Prozedur, die definiert, wie Quelldaten in eine Zieltabelle angewendet werden. Diese gespeicherte Prozedur wird pro Batch aufgerufen. Verwenden Sie für Vorgänge, die nur einmal ausgeführt werden und nichts mit Quelldaten zu tun haben, z. B. löschen oder abschneiden, die Skripteigenschaft "Pre-copy" .

    • Name der gespeicherten Prozedur: Wählen Sie die gespeicherte Prozedur aus, oder geben Sie den Namen der gespeicherten Prozedur manuell an, wenn Sie die Bearbeitung zum Lesen von Daten aus der Quelltabelle überprüfen.

    • Parameter für gespeicherte Prozeduren:

      • Tabellentyp: Geben Sie den Tabellentypnamen an, der in der gespeicherten Prozedur verwendet werden soll. Die Kopieraktivität macht die Daten, die in einer temporären Tabelle mit diesem Tabellentyp verschoben werden, verfügbar. Der gespeicherte Prozedurcode kann dann die kopierten Daten mit vorhandenen Daten zusammenführen.
      • Tabellentypparametername: Geben Sie den Parameternamen des in der gespeicherten Prozedur angegebenen Tabellentyps an.
      • Parameter: Geben Sie Werte für gespeicherte Prozedurparameter an. Zulässige Werte sind Namen oder Name-Wert-Paare. Die Namen und die Groß-/Kleinschreibung von Parametern müssen den Namen und der Groß-/Kleinschreibung der Parameter der gespeicherten Prozedur entsprechen. Sie können "Importparameter" auswählen, um die Parameter der gespeicherten Prozedur abzurufen.

      

• Tabellensperre für Masseneinfügung: Wählen Sie "Ja" oder "Nein" (Standardeinstellung) aus. Verwenden Sie diese Einstellung, um die Kopierleistung während eines Masseneinfügevorgangs in einer Tabelle ohne Index von mehreren Clients zu verbessern. Sie können diese Eigenschaft angeben, wenn Sie "Einfügen" oder "Upsert " als Schreibverhalten auswählen. Weitere Informationen hierzu: Gehen Sie zu BULK INSERT (Transact-SQL)

• Skript vorab kopieren: Geben Sie ein Skript für kopieraktivität an, das ausgeführt werden soll, bevor Sie Daten in eine Zieltabelle in jeder Ausführung schreiben. Sie können diese Eigenschaft nutzen, um die vorab geladenen Daten zu bereinigen.

• Zeitlimit für Batchschreibvorgang: Geben Sie die Wartezeit an, bis der Batch-Einfügevorgang beendet ist, bevor er eine Zeitüberschreitung verursacht. Der zulässige Wert ist ein Timespan-Wert. Wenn kein Wert angegeben ist, wird das Timeout standardmäßig auf "02:00:00" festgelegt.

• Batchgröße schreiben: Geben Sie die Anzahl der Zeilen an, die pro Batch in die SQL-Tabelle eingefügt werden sollen. Der zulässige Wert ist eine ganze Zahl (Anzahl von Zeilen). Standardmäßig bestimmt der Dienst die geeignete Batchgröße dynamisch auf der Grundlage der Zeilengröße.

• Maximale Anzahl gleichzeitiger Verbindungen: Die Obergrenze der gleichzeitigen Verbindungen zum Datenspeicher, die während des Ausführens der Aktivität hergestellt werden. Geben Sie diesen Wert nur an, wenn Sie die Anzahl der gleichzeitigen Verbindungen begrenzen möchten.

Kartierung

Für die Konfiguration der Registerkarte Zuordnung, wenn Sie Azure SQL Managed Instance ohne automatische Tabellenerstellung als Ziel nicht verwenden, wechseln Sie zur Zuordnung.

Wenn Sie Azure SQL Managed Instance mit automatischer Tabellenerstellung als Ziel verwenden, außer der Konfiguration von der Zuordnung, können Sie den Datentyp Ihrer Zielspalten bearbeiten. Nach dem Auswählen von Importschemas können Sie den Spaltentyp in Ihrem Ziel angeben.

Der Typ für die ID-Spalte in der Quelle ist z. B. int, und Sie können ihn beim Zuordnen zur Zielspalte in float-Typ ändern.

Einstellungen

Wechseln Sie für die Konfiguration der Registerkarte "Einstellungen " auf der Registerkarte "Einstellungen" zu "Andere Einstellungen konfigurieren".

Parallele Kopie aus verwalteter Azure SQL-Instanz

Der Connector für verwaltete Azure SQL-Instanz bei Kopieraktivitäten bietet integrierte Datenpartitionierung zum parallelen Kopieren von Daten. Sie finden die Optionen für die Datenpartitionierung auf der Registerkarte " Quelle " der Kopieraktivität.

Wenn Sie partitionierte Kopie aktivieren, führt kopieraktivität parallele Abfragen für Ihre Azure SQL Managed Instance-Quelle aus, um Daten nach Partitionen zu laden. Der parallele Grad wird durch den Grad der Kopierparallelität auf der Registerkarte "Kopieraktivitätseinstellungen" gesteuert. Wenn Sie beispielsweise den Grad der Kopierparallelität auf vier festlegen, generiert der Dienst gleichzeitig vier Abfragen basierend auf Der angegebenen Partitionsoption und -einstellungen, und jede Abfrage ruft einen Teil von Daten aus Ihrer azure SQL Managed Instance ab.

Sie werden empfohlen, parallele Kopie mit Datenpartitionierung zu aktivieren, insbesondere wenn Sie eine große Menge von Daten aus Ihrer azure SQL Managed Instance laden. Im Anschluss finden Sie empfohlene Konfigurationen für verschiedene Szenarien. Beim Kopieren von Daten in einen dateibasierten Datenspeicher wird empfohlen, mehrere Dateien in einen Ordner zu schreiben (nur den Ordnernamen anzugeben). In diesem Fall ist die Leistung besser als beim Schreiben in eine einzelne Datei.

Bewährte Methoden zum Laden von Daten mit Partitionierungsoption:

• Wählen Sie eine aussagekräftige Spalte als Partitionsspalte (wie Primärschlüssel oder eindeutiger Schlüssel), um Datenabweichungen zu vermeiden.
• Wenn die Tabelle über eine integrierte Partition verfügt, verwenden Sie die Partitionsoption Physische Partitionen der Tabelle , um eine bessere Leistung zu erzielen.

Beispielabfrage zur Überprüfung der physischen Partition

SELECT DISTINCT s.name AS SchemaName, t.name AS TableName, pf.name AS PartitionFunctionName, c.name AS ColumnName, iif(pf.name is null, 'no', 'yes') AS HasPartition
FROM sys.tables AS t
LEFT JOIN sys.objects AS o ON t.object_id = o.object_id
LEFT JOIN sys.schemas AS s ON o.schema_id = s.schema_id
LEFT JOIN sys.indexes AS i ON t.object_id = i.object_id 
LEFT JOIN sys.index_columns AS ic ON ic.partition_ordinal > 0 AND ic.index_id = i.index_id AND ic.object_id = t.object_id 
LEFT JOIN sys.columns AS c ON c.object_id = ic.object_id AND c.column_id = ic.column_id 
LEFT JOIN sys.partition_schemes ps ON i.data_space_id = ps.data_space_id 
LEFT JOIN sys.partition_functions pf ON pf.function_id = ps.function_id 
WHERE s.name='[your schema]' AND t.name = '[your table name]'

Wenn die Tabelle eine physische Partition besitzt, würde „HasPartition“ wie folgt als „Yes“ (Ja) angezeigt werden.

Tabellenzusammenfassung

In der folgenden Tabelle finden Sie die Zusammenfassung und weitere Informationen zur Azure SQL Managed Instance-Kopieraktivität.

Quellinformationen

Zielinformationen

Verwandte Inhalte

• Übersicht über die verwaltete Azure SQL-Instanz