Delen via

New-AzDataFactoryDataset

  • Referentie
Module:
Az.DataFactory

Hiermee maakt u een gegevensset in Data Factory.

Syntaxis

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

Description

De cmdlet New-AzDataFactoryDataset maakt een gegevensset in Azure Data Factory. Als u een naam opgeeft voor een gegevensset die al bestaat, wordt u door deze cmdlet gevraagd om bevestiging voordat de gegevensset wordt vervangen. Als u de parameter Force opgeeft, vervangt de cmdlet de bestaande gegevensset zonder bevestiging. Voer deze bewerkingen in de volgende volgorde uit:

  • Een data factory maken.
  • Gekoppelde services maken.
  • Gegevenssets maken.
  • Maak een pijplijn. Als er al een gegevensset met dezelfde naam in de data factory bestaat, wordt u met deze cmdlet gevraagd of u de bestaande gegevensset met de nieuwe gegevensset wilt overschrijven. Als u bevestigt dat de bestaande gegevensset wordt overschreven, wordt de definitie van de gegevensset ook vervangen.

Voorbeelden

Voorbeeld 1: Een gegevensset maken

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         : {}

Met deze opdracht maakt u een gegevensset met de naam DA_WikipediaClickEvents in de data factory met de naam WikiADF. Met de opdracht wordt de gegevensset gebaseerd op informatie in het DAWikipediaClickEvents.json-bestand.

Voorbeeld 2: Beschikbaarheid voor een nieuwe gegevensset weergeven

$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

Met de eerste opdracht maakt u een gegevensset met de naam DA_WikipediaClickEvents, zoals in een vorig voorbeeld, en wijst u die gegevensset vervolgens toe aan de $Dataset variabele. De tweede opdracht maakt gebruik van standaard dot notatie om details weer te geven over de eigenschap Beschikbaarheid van de gegevensset.

Voorbeeld 3: Locatie voor een nieuwe gegevensset weergeven

$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       : {}

Met de eerste opdracht maakt u een gegevensset met de naam DA_WikipediaClickEvents, zoals in een vorig voorbeeld, en wijst u die gegevensset vervolgens toe aan de $Dataset variabele. Met de tweede opdracht worden details weergegeven over de eigenschap Locatie van de gegevensset.

Voorbeeld 4: Validatieregels voor een nieuwe gegevensset weergeven

$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

Met de eerste opdracht maakt u een gegevensset met de naam DA_WikipediaClickEvents, zoals in een vorig voorbeeld, en wijst u die gegevensset vervolgens toe aan de $Dataset variabele. De tweede opdracht haalt details over de validatieregels voor de gegevensset op en geeft deze vervolgens door aan de Format-List cmdlet met behulp van de pijplijnoperator. Met deze Windows PowerShell-cmdlet worden de resultaten opgemaakt. Typ Get-Help Format-Listvoor meer informatie.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DataFactory

Hiermee geeft u een PSDataFactory-object. Met deze cmdlet maakt u een gegevensset in de data factory die met deze parameter wordt opgegeven.

Type:PSDataFactory
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DataFactoryName

Hiermee geeft u de naam van een data factory. Met deze cmdlet maakt u een gegevensset in de data factory die met deze parameter wordt opgegeven.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-File

Hiermee geeft u het volledige pad van het JSON-bestand (JavaScript Object Notation) op dat de beschrijving van de gegevensset bevat.

Type:String
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Geeft aan dat deze cmdlet een bestaande gegevensset vervangt zonder dat u om bevestiging wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de gegevensset die moet worden gemaakt.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van een Azure-resourcegroep op. Met deze cmdlet maakt u een gegevensset in de groep die met deze parameter wordt opgegeven.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSDataFactory

String

Uitvoerwaarden

PSDataset

Notities

  • Trefwoorden: azure, azurerm, arm, resource, beheer, manager, gegevens, factory's