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 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataFactory

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

Type:PSDataFactory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DataFactoryName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen des zu erstellenden Datasets an.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSDataFactory

String

Ausgaben

PSDataset

Hinweise

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