Generischer T-SQL-Abfrageauflistertyp

Generisches T-SQL-Abfrageeingabeschema

Das Schema für die generische T-SQL-Abfrageauflistereingabe lautet wie folgt.

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="DataCollectorType">
  <xs:element name="TSQLQueryCollector">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Query" minOccurs="1" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Value" type="xs:string" />
              <xs:element name="OutputTable" type="xs:string" />
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="Databases" minOccurs="0" maxOccurs="1">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Database" minOccurs="0" maxOccurs="unbounded" type="xs:string" />
            </xs:sequence>
            <xs:attribute name="UseSystemDatabases" type="xs:boolean" use="optional" />
            <xs:attribute name="UseUserDatabases" type="xs:boolean" use="optional" />
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Die folgenden Codebeispiele zeigen, wie das vorherige Schema verwendet werden kann. Ein vollständiges Codebeispiel finden Sie unter Vorgehensweise: Erstellen eines benutzerdefinierten Auflistsatzes, der einen generischen T-SQL-Abfrageauflistertyp verwendet.

Beispiel 1

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT DB_NAME() as db_name</Value>
    <OutputTable>VerifyDbName</OutputTable>
  </Query>
  <Databases UseSystemDatabases="true" UseUserDatabases="true" /> 
</ns:TSQLQueryCollector>

Beispiel 2

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM sys.objects</Value>
    <OutputTable>MyOutputTable1</OutputTable>
  </Query>
  <Databases>
    <Database>model</Database>
    <Database>tempdb</Database>
    <Database>master</Database>
  </Databases>
</ns:TSQLQueryCollector>

Beispiel 3

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM sys.dm_tran_database_transactions</Value>
    <OutputTable>MyOutputTable2</OutputTable>
  </Query>
  <Query>
    <Value>SELECT * FROM sys.dm_db_file_space_usage</Value>
    <OutputTable>MyOutputTable3</OutputTable>
  </Query>
  <Databases UseSystemDatabases="false" UseUserDatabases="true" />
</ns:TSQLQueryCollector>

Beispiel 4

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM mytable</Value> -- Query mytable
    <OutputTable>MyOutputTable1</OutputTable>
  </Query>
  <Databases>
    <Database>db1</Database>
  </Databases>
</ns:TSQLQueryCollector>

<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
  <Query>
    <Value>SELECT * FROM mytable</Value> -- Query mytable
    <OutputTable>MyOutputTable2</OutputTable>
  </Query>
  <Databases>
    <Database>db2</Database>
  </Databases>
</ns:TSQLQueryCollector>

Verarbeiten und Ausgeben

Die Metadaten der Abfrageausgabe sind von der vom Benutzer angegebenen Transact-SQL-Anweisung abhängig, die Spaltenzuordnungen in der Datenflussquelle oder in dem Datenflussziel werden jedoch zur Entwurfszeit erstellt. Dies bedeutet, dass für jedes Auflistelement, das diesen Auflistertyp verwendet, ein angepasstes Paket erforderlich ist, das zur Laufzeit generiert und auf das Format seines Schemas zugeschnitten wurde.

Der Datenauflister verwendet einen benutzerdefinierten Task, um ein Auflistungspaket und ein Paket zum Hochladen zu erstellen, wenn ein neues Auflistelement empfangen wird, oder wenn es eine Aktualisierung der Eingabeparameter für ein vorhandenes Auflistelement gibt. Diese Pakete werden in msdb gespeichert, sodass sie wiederverwendet werden können.

Das Verhalten beim Auflisten und Hochladen von Daten entspricht dem unter Architektur und Verarbeitung des Datenauflisters beschriebenen Verhalten, es wird jedoch für den generischen T-SQL-Abfrageauflistertyp etwas anders implementiert.

Die folgenden Verwaltungs-Data Warehouse-Tabellen werden zum Speichern der von dem generischen T-SQL-Abfrageauflistertyp aufgelisteten Daten verwendet:

• core.snapshots - Diese Tabelle identifiziert jeden neuen Snapshot.

• core.snapshot_timetable - Die Snapshotzeit wird in einer separaten Tabelle gespeichert, da viele Snapshots zur nahezu gleichen Zeit stattfinden können.

• core.source.info - In dieser Tabelle werden Informationen über die Datenquelle und die Daten gespeichert.

Einschränkungen

Es gibt bestimmte Einschränkungen, auf die beim Verwenden des generischen T-SQL-Abfrageauflistertyps geachtet werden muss:

• Die folgenden Spaltennamen sind für den Datenauflister reserviert: snapshot_time, snapshot_id und database_name. Diese Namen können von keinen von benutzerdefinierten Auflistsätzen erstellten Tabellen verwendet werden. Wenn versucht wird, sie zu verwenden, wird ein Fehler zurückgegeben.

• Eine Spalte vom Typ sysname wird in nvarchar(128) konvertiert, wenn sie in das Verwaltungs-Data Warehouse kopiert wird. Während der Datenauflistung konvertiert SQL Server 2008 Integration Services (SSIS) Datenbankdatentypen in SSIS-Datentypen (z. B. sysname wird zu DT_WSTR, und nvarchar(len) wird zu DT_WSTR). Diese Konvertierung wird im Datenflusstask der OLEDB-Quelle ausgeführt. Während des Hochladens der Daten liest der Datenauflister Daten aus dem Cache als SSIS-Datentyp, und die Daten werden als nvarchar(128) behandelt, was der Funktionalität von sysname entspricht.

• Eine Spalte vom Typ char(N) wird zu varchar(N), wenn sie in das Verwaltungs-Data Warehouse kopiert wird (char(N) kann in varchar(N) passen). Abgesehen davon, dass die char-Speichergröße im Gegensatz zur variablen varchar-Speichergröße fest ist, werden diese Typen als funktionell identisch behandelt.

• Eine Spalte vom Typ varbinary wird zu binary, wenn sie in das Verwaltungs-Data Warehouse kopiert wird.

• Eine Spalte vom Typ decimal wird zu numeric, wenn sie in das Verwaltungs-Data Warehouse kopiert wird.

• Eine Spalte vom Typ nchar wird zu nvarchar , wenn sie in das Verwaltungs-Data Warehouse kopiert wird.

• Der Typ sqlvariant wird von der Standardverarbeitung für Spalten behandelt, die SSIS nicht direkt behandelt. Dies bedeutet, dass die Spalten als nvarchar(255) behandelt werden und jede Konvertierung dem Datenanbieter überlassen wird.

  Hinweis
  In diesem Fall wird die Spalte mit einer Standardlänge von 255 Zeichen erstellt. Er kann jedoch auf 4000 Zeichen vergrößert werden.

• Alle von einer Transact-SQL-Abfrage zurückgegebenen Spalten müssen einen Namen haben. So funktioniert select 1 beispielsweise nicht, select 1 as one hingegen schon.

• Die folgenden Datentypen werden von SSIS nicht unterstützt und können nicht als Spalten in eine beliebige Ausgabetabelle einbezogen werden, die von einem Auflistsatz generiert wurde, der den generischen T-SQL-Abfrageauflistertyp verwendet:

  • image

  • text

  • ntext

  • XML

• Alle vom generischen T-SQL-Abfrageauflistertyp ausgeführten Abfragen müssen ein einzelnes Resultset zurückgeben.

• Abfragen lokaler temporärer Tabellen werden nur unterstützt, wenn sie zuerst als Teil desselben Batches deklariert werden. Abfragen globaler temporärer Tabellen werden vollständig unterstützt.

• Es werden keine Indizes, privaten Schlüssel, Fremdschlüssel oder andere Einschränkungen in die Zieltabellen des Verwaltungs-Data Warehouse übertragen. Dies liegt daran, dass dieselben Daten mehrfach abgefragt werden, und die Daten von mehreren Computern in einer einzelnen Tabelle zusammengefasst werden können.

• Etwaige andere Beschränkungen hinsichtlich des Typs unterstützter Abfragen, die für den Datenflusstask der OLE DB-Quelle von SSIS gelten, gelten auch für den generischen T-SQL-Abfrageauflistertyp.

Änderungsverlauf

Siehe auch

Aufgaben

Konzepte

Andere Ressourcen