Verwenden des Datenprofilerstellungs-Tasks im Paket-Workflow

Erstellen Sie in Business Intelligence Development Studio ein neues Integration Services-Paket.

Fügen Sie den ADO.NET-Verbindungs-Manager zum Paket hinzu. Konfigurieren Sie diesen Verbindungs-Manager für den .NET-Datenanbieter für SQL Server (SqlClient) und für die Verbindung mit einer verfügbaren Instanz der AdventureWorks2008R2-Datenbank.

Standardmäßig trägt der Verbindungs-Manager den folgenden Namen: <server name>AdventureWorks1.

Fügen Sie einen Dateiverbindungs-Manager zum Paket hinzu. Konfigurieren Sie diesen Verbindungs-Manager für das Erstellen der Ausgabedatei für den Datenprofilerstellungs-Task.

In diesem Beispiel wird der Dateiname "DataProfile1.xml" verwendet. Standardmäßig ist der Name des Verbindungs-Managers mit dem Dateinamen identisch.

Fügen Sie der Ablaufsteuerung einen Datenprofilerstellungs-Task hinzu.

Öffnen Sie den Editor für den Datenprofilerstellungs-Task, um den Task zu konfigurieren.

Wählen Sie auf der Seite Allgemein für Ziel den Namen des Dateiverbindungs-Managers aus, den Sie zuvor konfiguriert haben.

Erstellen Sie auf der Seite Profilanforderungen des Editors ein neues Profil für ein Spalten-NULL-Verhältnis.

Wählen Sie im Bereich Anforderungseigenschaften für ConnectionManager den ADO.NET-Verbindungs-Manager aus, den Sie zuvor konfiguriert haben. Wählen Sie dann für TableOrViewPerson.Address aus.

Schließen Sie den Editor für den Datenprofilerstellungs-Task.

Fügen Sie der Ablaufsteuerung einen Skripttask hinzu.

Verbinden Sie den Skripttask mit dem Datenprofilerstellungs-Task.

Öffnen Sie den Skripttask-Editor, um den Task zu konfigurieren.

Wählen Sie auf der Seite Skript die bevorzugte Programmiersprache aus. Machen Sie die beiden Paketvariablen anschließend für das Skript verfügbar:

1. Wählen Sie für ReadOnlyVariables die Option ProfileConnectionName aus.

2. Wählen Sie für ReadWriteVariables die Option AddressLine2NullRatio aus.

Wählen Sie Skript bearbeiten aus, um die Skriptentwicklungsumgebung zu öffnen.

Fügen Sie einen Verweis zum System.Xml-Namespace hinzu.

Geben Sie den Beispielcode ein, der der Programmiersprache entspricht:

Imports System
Imports Microsoft.SqlServer.Dts.Runtime
Imports System.Xml

Public Class ScriptMain

  Private FILENAME As String = "C:\ TEMP\DataProfile1.xml"
  Private PROFILE_NAMESPACE_URI As String = "https://schemas.microsoft.com/DataDebugger/"
  Private NULLCOUNT_XPATH As String = _
    "/default:DataProfile/default:DataProfileOutput/default:Profiles" & _
    "/default:ColumnNullRatioProfile[default:Column[@Name='AddressLine2']]/default:NullCount/text()"
  Private TABLE_XPATH As String = _
    "/default:DataProfile/default:DataProfileOutput/default:Profiles" & _
    "/default:ColumnNullRatioProfile[default:Column[@Name='AddressLine2']]/default:Table"

  Public Sub Main()

    Dim profileConnectionName As String
    Dim profilePath As String
    Dim profileOutput As New XmlDocument
    Dim profileNSM As XmlNamespaceManager
    Dim nullCountNode As XmlNode
    Dim nullCount As Integer
    Dim tableNode As XmlNode
    Dim rowCount As Integer
    Dim nullRatio As Double

    ' Open output file.
    profileConnectionName = Dts.Variables("ProfileConnectionName").Value.ToString()
    profilePath = Dts.Connections(profileConnectionName).ConnectionString
    profileOutput.Load(profilePath)
    profileNSM = New XmlNamespaceManager(profileOutput.NameTable)
    profileNSM.AddNamespace("default", PROFILE_NAMESPACE_URI)

    ' Get null count for column.
    nullCountNode = profileOutput.SelectSingleNode(NULLCOUNT_XPATH, profileNSM)
    nullCount = CType(nullCountNode.Value, Integer)

    ' Get row count for table.
    tableNode = profileOutput.SelectSingleNode(TABLE_XPATH, profileNSM)
    rowCount = CType(tableNode.Attributes("RowCount").Value, Integer)

    ' Compute and return null ratio.
    nullRatio = nullCount / rowCount
    Dts.Variables("AddressLine2NullRatio").Value = nullRatio

    Dts.TaskResult = Dts.Results.Success

  End Sub

End Class

using System;
using Microsoft.SqlServer.Dts.Runtime;
using System.Xml;

public class ScriptMain
{

  private string FILENAME = "C:\\ TEMP\\DataProfile1.xml";
  private string PROFILE_NAMESPACE_URI = "https://schemas.microsoft.com/DataDebugger/";
  private string NULLCOUNT_XPATH = "/default:DataProfile/default:DataProfileOutput/default:Profiles" + "/default:ColumnNullRatioProfile[default:Column[@Name='AddressLine2']]/default:NullCount/text()";
  private string TABLE_XPATH = "/default:DataProfile/default:DataProfileOutput/default:Profiles" + "/default:ColumnNullRatioProfile[default:Column[@Name='AddressLine2']]/default:Table";

  public void Main()
  {

    string profileConnectionName;
    string profilePath;
    XmlDocument profileOutput = new XmlDocument();
    XmlNamespaceManager profileNSM;
    XmlNode nullCountNode;
    int nullCount;
    XmlNode tableNode;
    int rowCount;
    double nullRatio;

    // Open output file.
    profileConnectionName = Dts.Variables["ProfileConnectionName"].Value.ToString();
    profilePath = Dts.Connections[profileConnectionName].ConnectionString;
    profileOutput.Load(profilePath);
    profileNSM = new XmlNamespaceManager(profileOutput.NameTable);
    profileNSM.AddNamespace("default", PROFILE_NAMESPACE_URI);

    // Get null count for column.
    nullCountNode = profileOutput.SelectSingleNode(NULLCOUNT_XPATH, profileNSM);
    nullCount = (int)nullCountNode.Value;

    // Get row count for table.
    tableNode = profileOutput.SelectSingleNode(TABLE_XPATH, profileNSM);
    rowCount = (int)tableNode.Attributes["RowCount"].Value;

    // Compute and return null ratio.
    nullRatio = nullCount / rowCount;
    Dts.Variables["AddressLine2NullRatio"].Value = nullRatio;

    Dts.TaskResult = Dts.Results.Success;

  }

}

Hinweis
Der in diesem Verfahren angezeigte Beispielcode veranschaulicht, wie die Ausgabe des Datenprofilerstellungs-Tasks aus einer Datei geladen wird. Um die Ausgabe des Datenprofilerstellungs-Tasks stattdessen aus einer Paketvariablen zu laden, verwenden Sie den alternativen Beispielcode, der im Anschluss an dieses Verfahren dargestellt wird.

Schließen Sie die Skriptentwicklungsumgebung, und schließen Sie dann den Skripttask-Editor.