Freigeben über

New-AzDataFactoryDataset

  • Referenz
Modul:
Az.DataFactory

Erstellt ein Dataset in Data Factory.

Syntax

New-AzDataFactoryDataset
   [-DataFactoryName] <String>
   [[-Name] <String>]
   [-File] <String>
   [-Force]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
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 Sie eine Datenfactory.
  • Erstellen Sie verknüpfte Dienste.
  • Erstellen Sie Datasets.
  • Erstellen Sie eine 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 Get-Help Format-Listein, um weitere Informationen zu erfahren.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataFactory

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

Typ:PSDataFactory
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DataFactoryName

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

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-File

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

Typ:String
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu erstellenden Datasets an.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSDataFactory

String

Ausgaben

PSDataset

Hinweise

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