Udostępnij przez


New-AzDataFactoryDataset

Tworzy zestaw danych w usłudze Data Factory.

Składnia

ByFactoryName (Domyślne)

New-AzDataFactoryDataset
    [-DataFactoryName] <String>
    [[-Name] <String>]
    [-File] <String>
    [-ResourceGroupName] <String>
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByFactoryObject

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.
  • Utwórz rurociąg. 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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataFactory

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

Właściwości parametrów

Typ:PSDataFactory
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByFactoryObject
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DataFactoryName

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByFactoryName
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-File

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:3
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Force

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Name

Określa nazwę zestawu danych do utworzenia.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:2
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ResourceGroupName

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ByFactoryName
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

PSDataFactory

String

Wyjść

PSDataset

Notatki

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