Compartir a través de

New-AzDataFactoryDataset

  • Referencia
Módulo:
Az.DataFactory

Crea un conjunto de datos en Data Factory.

Sintaxis

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.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DataFactory

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

Tipo:PSDataFactory
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

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

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSDataFactory

String

Salidas

PSDataset

Notas

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