New-AzDataFactoryDataset
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 einer Data Factory.
- Erstellen Sie verknüpfte Dienste.
- Erstellen von 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. Mit dem Befehl wird das Dataset auf Informationen in der DAWikipediaClickEvents.json Datei basieren.
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 Folgendes ein, um weitere Informationen zu erhalten: Get-Help Format-List
.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
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 geschieht, 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
Ausgaben
Hinweise
- Schlüsselwörter: azure, azurerm, arm, resource, management, manager, data, factories
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für