Udostępnij za pośrednictwem

New-AzDataFactoryDataset

  • Odwołanie
Moduł:
Az.DataFactory

Tworzy zestaw danych w usłudze Data Factory.

Składnia

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

Opis

Polecenie cmdlet New-AzDataFactoryDataset tworzy zestaw danych w usłudze Azure Data Factory. Jeśli określisz nazwę zestawu danych, który już istnieje, to polecenie cmdlet wyświetli monit o potwierdzenie przed zastąpieniem zestawu danych. Jeśli określisz parametr Force , polecenie cmdlet zastąpi istniejący zestaw danych bez potwierdzenia. Wykonaj te operacje w następującej kolejności:

  • Tworzenie fabryki danych.
  • Tworzenie połączonych usług.
  • Tworzenie zestawów danych.
  • Tworzenie potoku. Jeśli zestaw danych o tej samej nazwie już istnieje w fabryce danych, to polecenie cmdlet wyświetli monit o potwierdzenie, czy zastąpić istniejący zestaw danych nowym zestawem danych. Jeśli potwierdzisz zastąpienie istniejącego zestawu danych, definicja zestawu danych zostanie również zamieniona.

Przykłady

Przykład 1. Tworzenie zestawu danych

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

To polecenie tworzy zestaw danych o nazwie DA_WikipediaClickEvents w fabryce danych o nazwie WikiADF. Polecenie opiera zestaw danych na informacjach w pliku DAWikipediaClickEvents.json.

Przykład 2. Wyświetlanie dostępności nowego zestawu danych

$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

Pierwsze polecenie tworzy zestaw danych o nazwie DA_WikipediaClickEvents, jak w poprzednim przykładzie, a następnie przypisuje ten zestaw danych do zmiennej $Dataset. Drugie polecenie używa standardowej notacji kropkowej, aby wyświetlić szczegółowe informacje o właściwości Availability zestawu danych.

Przykład 3. Wyświetlanie lokalizacji nowego zestawu danych

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

Pierwsze polecenie tworzy zestaw danych o nazwie DA_WikipediaClickEvents, jak w poprzednim przykładzie, a następnie przypisuje ten zestaw danych do zmiennej $Dataset. Drugie polecenie wyświetla szczegółowe informacje o właściwości Location zestawu danych.

Przykład 4. Wyświetlanie reguł walidacji dla nowego zestawu danych

$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

Pierwsze polecenie tworzy zestaw danych o nazwie DA_WikipediaClickEvents, jak w poprzednim przykładzie, a następnie przypisuje ten zestaw danych do zmiennej $Dataset. Drugie polecenie pobiera szczegółowe informacje o regułach walidacji zestawu danych, a następnie przekazuje je do polecenia cmdlet Format-List przy użyciu operatora potoku. To polecenie cmdlet programu Windows PowerShell formatuje wyniki. Aby uzyskać więcej informacji, wpisz Get-Help Format-List.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DataFactory

Określa obiekt PSDataFactory . To polecenie cmdlet tworzy zestaw danych w fabryce danych, który określa ten parametr.

Typ:PSDataFactory
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DataFactoryName

Określa nazwę fabryki danych. To polecenie cmdlet tworzy zestaw danych w fabryce danych, który określa ten parametr.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-File

Określa pełną ścieżkę pliku JavaScript Object Notation (JSON), który zawiera opis zestawu danych.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wskazuje, że to polecenie cmdlet zastępuje istniejący zestaw danych bez monitowania o potwierdzenie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę zestawu danych do utworzenia.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów platformy Azure. To polecenie cmdlet tworzy zestaw danych w grupie, która określa ten parametr.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSDataFactory

String

Dane wyjściowe

PSDataset

Uwagi

  • Słowa kluczowe: azure, azurerm, arm, resource, management, manager, data, factory