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

説明

New-AzDataFactoryDataset コマンドレットは、Azure Data Factory にデータセットを作成します。 既に存在するデータセットの名前を指定すると、このコマンドレットはデータセットを置き換える前に確認を求められます。 Force パラメーターを指定すると、コマンドレットは確認なしで既存のデータセットを置き換えます。 次の順序でこれらの操作を実行します。

  • データ ファクトリを作成します。
  • リンクされたサービスを作成します。
  • データセットを作成します。
  • パイプラインを作成します。 同じ名前のデータセットが既にデータ ファクトリに存在する場合、このコマンドレットは、既存のデータセットを新しいデータセットで上書きするかどうかを確認するメッセージを表示します。 既存のデータセットを上書きすることを確認すると、データセット定義も置き換えられます。

例

例 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 変数に割り当てます。 2 番目のコマンドでは、標準のドット表記を使用して、データセットの 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 変数に割り当てます。 2 番目のコマンドは、データセットの 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 変数に割り当てます。 2 番目のコマンドは、データセットの検証規則に関する詳細を取得し、パイプライン演算子を使用して Format-List コマンドレットに渡します。 その Windows PowerShell コマンドレットによって結果が書式設定されます。 詳細を表示するには「Get-Help Format-List」を入力します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataFactory

PSDataFactory オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータセットをデータ ファクトリに作成します。

Type:PSDataFactory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DataFactoryName

データ ファクトリの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータセットをデータ ファクトリに作成します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

データセットの説明を含む JavaScript Object Notation (JSON) ファイルの完全なパスを指定します。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

確認を求めずに、このコマンドレットが既存のデータセットを置き換えることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

作成するデータセットの名前を指定します。

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Azure リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータセットをグループ内に作成します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSDataFactory

String

出力

PSDataset

メモ

  • キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, データ, ファクトリ