Dela via

New-AzDataFactoryDataset

  • Referens
Modul:
Az.DataFactory

Skapar en datauppsättning i 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>]

Description

Cmdleten New-AzDataFactoryDataset skapar en datauppsättning i Azure Data Factory. Om du anger ett namn för en datauppsättning som redan finns uppmanas du att bekräfta den här cmdleten innan den ersätter datauppsättningen. Om du anger force-parametern ersätter cmdleten den befintliga datauppsättningen utan bekräftelse. Utför dessa åtgärder i följande ordning:

  • Skapa en datafabrik.
  • Skapa länkade tjänster.
  • Skapa datauppsättningar.
  • Skapa en pipeline. Om det redan finns en datauppsättning med samma namn i datafabriken uppmanas du i den här cmdleten att bekräfta om du vill skriva över den befintliga datauppsättningen med den nya datauppsättningen. Om du bekräftar att du skriver över den befintliga datamängden ersätts även datauppsättningsdefinitionen.

Exempel

Exempel 1: Skapa en datauppsättning

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

Det här kommandot skapar en datauppsättning med namnet DA_WikipediaClickEvents i datafabriken med namnet WikiADF. Kommandot baserar datamängden på information i filen DAWikipediaClickEvents.json.

Exempel 2: Visa tillgänglighet för en ny datauppsättning

$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

Det första kommandot skapar en datauppsättning med namnet DA_WikipediaClickEvents, som i ett tidigare exempel, och tilldelar sedan datauppsättningen till variabeln $Dataset. Det andra kommandot använder standardpunktskommentation för att visa information om datauppsättningens tillgänglighetsegenskap.

Exempel 3: Visa plats för en ny datauppsättning

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

Det första kommandot skapar en datauppsättning med namnet DA_WikipediaClickEvents, som i ett tidigare exempel, och tilldelar sedan datauppsättningen till variabeln $Dataset. Det andra kommandot visar information om datamängdens platsegenskap.

Exempel 4: Visa verifieringsregler för en ny datauppsättning

$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

Det första kommandot skapar en datauppsättning med namnet DA_WikipediaClickEvents, som i ett tidigare exempel, och tilldelar sedan datauppsättningen till variabeln $Dataset. Det andra kommandot hämtar information om verifieringsreglerna för datamängden och skickar dem sedan till cmdleten Format-List med hjälp av pipelineoperatorn. Windows PowerShell-cmdleten formaterar resultatet. Om du vill ha mer information skriver du Get-Help Format-List.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DataFactory

Anger ett PSDataFactory-objekt . Den här cmdleten skapar en datauppsättning i datafabriken som den här parametern anger.

Typ:PSDataFactory
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DataFactoryName

Anger namnet på en datafabrik. Den här cmdleten skapar en datauppsättning i datafabriken som den här parametern anger.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-File

Anger den fullständiga sökvägen till JSON-filen (JavaScript Object Notation) som innehåller beskrivningen av datauppsättningen.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att den här cmdleten ersätter en befintlig datauppsättning utan att du uppmanas att bekräfta.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på datauppsättningen som ska skapas.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på en Azure-resursgrupp. Den här cmdleten skapar en datauppsättning i den grupp som den här parametern anger.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSDataFactory

String

Utdata

PSDataset

Kommentarer

  • Nyckelord: azure, azurerm, arm, resource, management, manager, data, factories