New-AzDataFactoryDataset

Crea un conjunto de datos en Data Factory.

Syntax

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

El cmdlet New-AzDataFactoryDataset crea un conjunto de datos en Azure Data Factory. Si especifica un nombre para un conjunto de datos que ya existe, este cmdlet le pedirá confirmación antes de reemplazar el conjunto de datos. Si especifica el parámetro Force , el cmdlet reemplaza el conjunto de datos existente sin confirmación. Realice estas operaciones en el orden siguiente:

  • Creación de una factoría de datos.
  • Cree servicios vinculados.
  • Creación de conjuntos de datos.
  • Crear una canalización. Si ya existe un conjunto de datos con el mismo nombre en la factoría de datos, este cmdlet le pedirá que confirme si se sobrescribe el conjunto de datos existente con el nuevo conjunto de datos. Si confirma que sobrescribe el conjunto de datos existente, la definición del conjunto de datos también se reemplaza.

Ejemplos

Ejemplo 1: Creación de un conjunto de datos

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

Este comando crea un conjunto de datos denominado DA_WikipediaClickEvents en la factoría de datos denominada WikiADF. El comando basa el conjunto de datos en la información del archivo DAWikipediaClickEvents.json.

Ejemplo 2: Visualización de la disponibilidad de un nuevo conjunto de datos

$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

El primer comando crea un conjunto de datos denominado DA_WikipediaClickEvents, como en un ejemplo anterior y, a continuación, asigna ese conjunto de datos a la variable $Dataset. El segundo comando usa la notación de puntos estándar para mostrar detalles sobre la propiedad Availability del conjunto de datos.

Ejemplo 3: Visualización de la ubicación de un nuevo conjunto de datos

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

El primer comando crea un conjunto de datos denominado DA_WikipediaClickEvents, como en un ejemplo anterior y, a continuación, asigna ese conjunto de datos a la variable $Dataset. El segundo comando muestra detalles sobre la propiedad Location del conjunto de datos.

Ejemplo 4: Visualización de reglas de validación para un nuevo conjunto de datos

$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

El primer comando crea un conjunto de datos denominado DA_WikipediaClickEvents, como en un ejemplo anterior y, a continuación, asigna ese conjunto de datos a la variable $Dataset. El segundo comando obtiene detalles sobre las reglas de validación del conjunto de datos y, a continuación, los pasa al cmdlet Format-List mediante el operador de canalización. Ese cmdlet de Windows PowerShell da formato a los resultados. Para obtener más información, escriba Get-Help Format-List.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DataFactory

Especifica un objeto PSDataFactory . Este cmdlet crea un conjunto de datos en la factoría de datos que especifica este parámetro.

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

-DataFactoryName

Especifica el nombre de una factoría de datos. Este cmdlet crea un conjunto de datos en la factoría de datos que especifica este parámetro.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

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

-File

Especifica la ruta de acceso completa del archivo de notación de objetos JavaScript (JSON) que contiene la descripción del conjunto de datos.

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

-Force

Indica que este cmdlet reemplaza un conjunto de datos existente sin solicitar confirmación.

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

-Name

Especifica el nombre del conjunto de datos que se va a crear.

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

-ResourceGroupName

Especifica el nombre de un grupo de recursos de Azure. Este cmdlet crea un conjunto de datos en el grupo que especifica este parámetro.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

PSDataFactory

String

Salidas

PSDataset

Notas

  • Palabras clave: azure, azurerm, arm, resource, management, manager, data, factorys