Compartilhar via

New-AzDataFactoryDataset

Módulo:
Az.DataFactory Module

Cria um conjunto de dados no Data Factory.

Sintaxe

ByFactoryName (Default) 

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

Description

O cmdlet New-AzDataFactoryDataset cria um conjunto de dados no Azure Data Factory. Se você especificar um nome para um conjunto de dados que já existe, esse cmdlet solicitará a confirmação antes que ele substitua o conjunto de dados. Se você especificar o parâmetro Force , o cmdlet substituirá o conjunto de dados existente sem confirmação. Execute estas operações na seguinte ordem:

  • Crie uma fábrica de dados.
  • Criar serviços vinculados.
  • Criar conjuntos de dados.
  • Crie um pipeline. Se já existir um conjunto de dados com o mesmo nome no data factory, esse cmdlet solicitará que você confirme se deseja substituir o conjunto de dados existente com o novo conjunto de dados. Se você confirmar a substituição do conjunto de dados existente, a definição do conjunto de dados também será substituída.

Exemplos

Exemplo 1: Criar um conjunto de dados

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

Esse comando cria um conjunto de dados chamado DA_WikipediaClickEvents no data factory chamado WikiADF. O comando baseia o conjunto de dados em informações no arquivo DAWikipediaClickEvents.json.

Exemplo 2: exibir a disponibilidade de um novo conjunto de dados

$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

O primeiro comando cria um conjunto de dados chamado DA_WikipediaClickEvents, como em um exemplo anterior, e atribui esse conjunto de dados à variável $Dataset. O segundo comando usa a notação de ponto padrão para exibir detalhes sobre a propriedade Disponibilidade do conjunto de dados.

Exemplo 3: Exibir o local de um novo conjunto de dados

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

O primeiro comando cria um conjunto de dados chamado DA_WikipediaClickEvents, como em um exemplo anterior, e atribui esse conjunto de dados à variável $Dataset. O segundo comando exibe detalhes sobre a propriedade Location do conjunto de dados.

Exemplo 4: exibir regras de validação para um novo conjunto de dados

$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

O primeiro comando cria um conjunto de dados chamado DA_WikipediaClickEvents, como em um exemplo anterior, e atribui esse conjunto de dados à variável $Dataset. O segundo comando obtém detalhes sobre as regras de validação para o conjunto de dados e, em seguida, passa-os para o cmdlet Format-List usando o operador de pipeline. Esse cmdlet do Windows PowerShell formata os resultados. Para obter mais informações, digite Get-Help Format-List.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DataFactory

Especifica um objeto PSDataFactory . Esse cmdlet cria um conjunto de dados no data factory especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:PSDataFactory
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByFactoryObject
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DataFactoryName

Especifica o nome de um data factory. Esse cmdlet cria um conjunto de dados no data factory especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByFactoryName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-File

Especifica o caminho completo do arquivo JSON (JavaScript Object Notation) que contém a descrição do conjunto de dados.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Indica que esse cmdlet substitui um conjunto de dados existente sem solicitar confirmação.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do conjunto de dados a ser criado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome de um grupo de recursos do Azure. Esse cmdlet cria um conjunto de dados no grupo especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByFactoryName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSDataFactory

String

Saídas

PSDataset

Observações

  • Palavras-chave: azure, azurerm, arm, resource, management, manager, data, factories