Freigeben über

New-AzDataFactoryDataset

Modul:
Az.DataFactory Module

Erstellt ein Dataset in Data Factory.

Syntax

ByFactoryName (Standard) 

New-AzDataFactoryDataset
    [-DataFactoryName] <String>
    [[-Name] <String>]
    [-File] <String>
    [-ResourceGroupName] <String>
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByFactoryObject 

New-AzDataFactoryDataset
    [-DataFactory] <PSDataFactory>
    [[-Name] <String>]
    [-File] <String>
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzDataFactoryDataset erstellt ein Dataset in Azure Data Factory. Wenn Sie einen Namen für ein bereits vorhandenes Dataset angeben, werden Sie mit diesem Cmdlet zur Bestätigung aufgefordert, bevor das Dataset ersetzt wird. Wenn Sie den Parameter Force angeben, ersetzt das Cmdlet das vorhandene Dataset ohne Bestätigung. Führen Sie diese Vorgänge in der folgenden Reihenfolge aus:

  • Erstellen einer Data Factory.
  • Erstellen Sie verknüpfte Dienste.
  • Erstellen Sie Datasets.
  • Erstellen einer Pipeline. Wenn ein Dataset mit demselben Namen bereits in der Datenfactory vorhanden ist, werden Sie von diesem Cmdlet aufgefordert, zu bestätigen, ob das vorhandene Dataset mit dem neuen Dataset überschrieben werden soll. Wenn Sie bestätigen, dass das vorhandene Dataset überschrieben wird, wird auch die Datasetdefinition ersetzt.

Beispiele

Beispiel 1: Erstellen eines Datasets

New-AzDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"

DatasetName         : DAWikipediaClickEvents
ResourceGroupName : ADF
DataFactoryName   : WikiADF
Availability      : Microsoft.DataFactories.Availability
Location          : Microsoft.DataFactories.AzureBlobLocation
Policy            : Microsoft.DataFactories.Policy
Structure         : {}

Mit diesem Befehl wird ein Dataset namens DA_WikipediaClickEvents in der Datenfactory namens WikiADF erstellt. Der Befehl basiert auf Informationen in der DAWikipediaClickEvents.json Datei.

Beispiel 2: Anzeigen der Verfügbarkeit für ein neues Dataset

$Dataset = New-AzDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"
$Dataset.Availability

AnchorDateTime :
Frequency      : Hour
Interval       : 1
Offset         :
WaitOnExternal : Microsoft.DataFactories.WaitOnExternal

Der erste Befehl erstellt ein Dataset mit dem Namen DA_WikipediaClickEvents, wie in einem vorherigen Beispiel, und weist dieses Dataset dann der $Dataset Variablen zu. Der zweite Befehl verwendet die standardmäßige Punktnotation, um Details zur Verfügbarkeitseigenschaft des Datasets anzuzeigen.

Beispiel 3: Anzeigen des Speicherorts für ein neues Dataset

$Dataset = New-AzDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"
$Dataset.Location

BlobPath          : wikidatagateway/wikisampledatain/
FilenamePrefix    :
Format            :
LinkedServiceName : LinkedServiceWikipediaClickEvents
PartitionBy       : {}

Der erste Befehl erstellt ein Dataset mit dem Namen DA_WikipediaClickEvents, wie in einem vorherigen Beispiel, und weist dieses Dataset dann der $Dataset Variablen zu. Der zweite Befehl zeigt Details zur Location-Eigenschaft des Datasets an.

Beispiel 4: Anzeigen von Gültigkeitsprüfungsregeln für ein neues Dataset

$Dataset = New-AzDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"
$Dataset.Policy.Validation | Format-List $dataset.Location

BlobPath          : wikidatagateway/wikisampledatain/
FilenamePrefix    :
Format            :
LinkedServiceName : LinkedServiceWikipediaClickEvents
PartitionBy       : {}

MinimumRows   :
MinimumSizeMB : 1

Der erste Befehl erstellt ein Dataset mit dem Namen DA_WikipediaClickEvents, wie in einem vorherigen Beispiel, und weist dieses Dataset dann der $Dataset Variablen zu. Der zweite Befehl ruft Details zu den Validierungsregeln für das Dataset ab und übergibt sie dann mithilfe des Pipelineoperators an das Cmdlet Format-List. Dieses Windows PowerShell-Cmdlet formatiert die Ergebnisse. Geben Sie weitere Informationen ein Get-Help Format-List.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DataFactory

Gibt ein PSDataFactory -Objekt an. Mit diesem Cmdlet wird ein Dataset in der Datenfactory erstellt, das dieser Parameter angibt.

Parametereigenschaften

Typ:PSDataFactory
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryObject
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DataFactoryName

Gibt den Namen einer Datenfactory an. Mit diesem Cmdlet wird ein Dataset in der Datenfactory erstellt, das dieser Parameter angibt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryName
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-File

Gibt den vollständigen Pfad der JSON-Datei (JavaScript Object Notation) an, die die Beschreibung des Datasets enthält.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Gibt an, dass dieses Cmdlet ein vorhandenes Dataset ersetzt, ohne Sie zur Bestätigung aufzufordern.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen des zu erstellenden Datasets an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen einer Azure-Ressourcengruppe an. Mit diesem Cmdlet wird ein Dataset in der Gruppe erstellt, die dieser Parameter angibt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFactoryName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSDataFactory

String

Ausgaben

PSDataset

Hinweise

  • Schlüsselwörter: azure, azurerm, arm, resource, management, manager, data, factories