共用方式為

New-AzDataFactoryDataset

  • 參考
模組:
Az.DataFactory

在 Data Factory 中建立數據集。

語法

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

New-AzDataFactoryDataset Cmdlet 會在 Azure Data Factory 中建立數據集。 如果您指定已存在的數據集名稱，此 Cmdlet 會在取代資料集之前提示您進行確認。 如果您指定 Force 參數，Cmdlet 會取代現有的數據集，而不需確認。 依照下列順序執行這些作業：

  • 建立資料處理站。
  • 建立連結的服務。
  • 建立數據集。
  • 建立 管線。 如果數據處理站中已有同名的數據集，此 Cmdlet 會提示您確認是否要以新的數據集覆寫現有的數據集。 如果您確認覆寫現有的數據集，數據集定義也會被取代。

範例

範例 1：建立數據集

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

此命令會在名為WikiADF的數據處理站中建立名為 DA_WikipediaClickEvents的數據集。 命令會將數據集以DAWikipediaClickEvents.json檔案中的資訊為基礎。

範例 2：檢視新數據集的可用性

$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

第一個命令會建立名為 DA_WikipediaClickEvents 的數據集，如先前範例所示，然後將該數據集指派給$Dataset變數。 第二個命令會使用標準點表示法來顯示數據集之 Availability 屬性的詳細數據。

範例 3：檢視新數據集的位置

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

第一個命令會建立名為 DA_WikipediaClickEvents 的數據集，如先前範例所示，然後將該數據集指派給$Dataset變數。 第二個命令會顯示數據集之 Location 屬性的詳細數據。

範例 4：檢視新數據集的驗證規則

$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

第一個命令會建立名為 DA_WikipediaClickEvents 的數據集，如先前範例所示，然後將該數據集指派給$Dataset變數。 第二個命令會取得數據集驗證規則的詳細數據，然後使用管線運算符將它們傳遞至 Format-List Cmdlet。 該 Windows PowerShell Cmdlet 會將結果格式化。 如需詳細資訊，請輸入 Get-Help Format-List。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DataFactory

指定 PSDataFactory 物件。 這個 Cmdlet 會在數據處理站中建立此參數所指定的數據集。

類型:PSDataFactory
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DataFactoryName

指定數據處理站的名稱。 這個 Cmdlet 會在數據處理站中建立此參數所指定的數據集。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-File

指定包含數據集描述之 JavaScript 物件表示法 （JSON） 檔案的完整路徑。

類型:String
Position:3
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Force

指出此 Cmdlet 會取代現有的數據集，而不會提示您進行確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要建立的數據集名稱。

類型:String
Position:2
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ResourceGroupName

指定 Azure 資源群組的名稱。 這個 Cmdlet 會在此參數指定的群組中建立數據集。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSDataFactory

String

輸出

PSDataset

備註

  • 關鍵詞：azure、azurerm、arm、resource、management、manager、data、factory