New-AzDataFactoryDataset

  • Reference
Modul:
Az.DataFactory

Vytvoří datovou sadu ve službě Data Factory.

Syntaxe

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

Rutina New-AzDataFactoryDataset vytvoří datovou sadu ve službě Azure Data Factory. Pokud zadáte název datové sady, která už existuje, zobrazí tato rutina výzvu k potvrzení před nahrazením datové sady. Pokud zadáte parametr Force , rutina nahradí existující datovou sadu bez potvrzení. Proveďte tyto operace v následujícím pořadí:

  • Vytvoření datové továrny
  • Vytvoření propojených služeb
  • Vytváření datových sad
  • Vytvořit kanál. Pokud datová sada se stejným názvem už v datové továrně existuje, tato rutina vás vyzve k potvrzení, jestli chcete existující datovou sadu přepsat novou datovou sadou. Pokud potvrdíte přepsání existující datové sady, nahradí se také definice datové sady.

Příklady

Příklad 1: Vytvoření datové sady

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

Tento příkaz vytvoří datovou sadu s názvem DA_WikipediaClickEvents v datové továrně s názvem WikiADF. Příkaz zakází datovou sadu na informacích v souboru DAWikipediaClickEvents.json.

Příklad 2: Zobrazení dostupnosti nové datové sady

$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

První příkaz vytvoří datovou sadu s názvem DA_WikipediaClickEvents, jako v předchozím příkladu, a pak ji přiřadí k proměnné $Dataset. Druhý příkaz používá standardní zápis tečky k zobrazení podrobností o vlastnosti Availability datové sady.

Příklad 3: Zobrazení umístění nové datové sady

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

První příkaz vytvoří datovou sadu s názvem DA_WikipediaClickEvents, jako v předchozím příkladu, a pak ji přiřadí k proměnné $Dataset. Druhý příkaz zobrazí podrobnosti o vlastnosti Location datové sady.

Příklad 4: Zobrazení ověřovacích pravidel pro novou datovou sadu

$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

První příkaz vytvoří datovou sadu s názvem DA_WikipediaClickEvents, jako v předchozím příkladu, a pak ji přiřadí k proměnné $Dataset. Druhý příkaz získá podrobnosti o ověřovacích pravidlech datové sady a pak je předá rutině Format-List pomocí operátoru kanálu. Tato rutina Prostředí Windows PowerShell formátuje výsledky. Další informace potřebujete zadáním Get-Help Format-List.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DataFactory

Určuje objekt PSDataFactory . Tato rutina vytvoří datovou sadu v datové továrně, kterou tento parametr určuje.

Typ:PSDataFactory
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DataFactoryName

Určuje název datové továrny. Tato rutina vytvoří datovou sadu v datové továrně, kterou tento parametr určuje.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-File

Určuje úplnou cestu k souboru JSON (JavaScript Object Notation), který obsahuje popis datové sady.

Typ:String
Position:3
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Označuje, že tato rutina nahradí existující datovou sadu bez výzvy k potvrzení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název datové sady, která se má vytvořit.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků Azure. Tato rutina vytvoří datovou sadu ve skupině, kterou tento parametr určuje.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSDataFactory

String

Výstupy

PSDataset

Poznámky

  • Klíčová slova: azure, azurerm, arm, resource, management, manager, data, factory