Partager via

New-AzDataFactoryDataset

  • Référence
Module:
Az.DataFactory

Crée un jeu de données dans Data Factory.

Syntaxe

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

L’applet de commande New-AzDataFactoryDataset crée un jeu de données dans Azure Data Factory. Si vous spécifiez un nom pour un jeu de données qui existe déjà, cette applet de commande vous invite à confirmer avant de remplacer le jeu de données. Si vous spécifiez le paramètre Force , l’applet de commande remplace le jeu de données existant sans confirmation. Effectuez ces opérations dans l’ordre suivant :

  • Créer une fabrique de données.
  • créez des services liés.
  • Créez les jeux de données.
  • Créer un pipeline. Si un jeu de données portant le même nom existe déjà dans la fabrique de données, cette applet de commande vous invite à confirmer s’il faut remplacer le jeu de données existant avec le nouveau jeu de données. Si vous confirmez de remplacer le jeu de données existant, la définition du jeu de données est également remplacée.

Exemples

Exemple 1 : Créer un jeu de données

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

Cette commande crée un jeu de données nommé DA_WikipediaClickEvents dans la fabrique de données nommée WikiADF. La commande base le jeu de données sur des informations dans le fichier DAWikipediaClickEvents.json.

Exemple 2 : Afficher la disponibilité d’un nouveau jeu de données

$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

La première commande crée un jeu de données nommé DA_WikipediaClickEvents, comme dans un exemple précédent, puis affecte ce jeu de données à la variable $Dataset. La deuxième commande utilise la notation par points standard pour afficher des détails sur la propriété Availability du jeu de données.

Exemple 3 : Afficher l’emplacement d’un nouveau jeu de données

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

La première commande crée un jeu de données nommé DA_WikipediaClickEvents, comme dans un exemple précédent, puis affecte ce jeu de données à la variable $Dataset. La deuxième commande affiche des détails sur la propriété Location du jeu de données.

Exemple 4 : Afficher les règles de validation d’un nouveau jeu de données

$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

La première commande crée un jeu de données nommé DA_WikipediaClickEvents, comme dans un exemple précédent, puis affecte ce jeu de données à la variable $Dataset. La deuxième commande obtient des détails sur les règles de validation du jeu de données, puis les transmet à l’applet de commande Format-List à l’aide de l’opérateur de pipeline. Cette applet de commande Windows PowerShell met en forme les résultats. Pour plus d'informations, voir Get-Help Format-List.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DataFactory

Spécifie un objet PSDataFactory . Cette applet de commande crée un jeu de données dans la fabrique de données spécifiée par ce paramètre.

Type:PSDataFactory
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DataFactoryName

Spécifie le nom d’une fabrique de données. Cette applet de commande crée un jeu de données dans la fabrique de données spécifiée par ce paramètre.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-File

Spécifie le chemin complet du fichier JSON (JavaScript Object Notation) qui contient la description du jeu de données.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Indique que cette applet de commande remplace un jeu de données existant sans vous inviter à confirmer.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom du jeu de données à créer.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom d’un groupe de ressources Azure. Cette applet de commande crée un jeu de données dans le groupe spécifié par ce paramètre.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSDataFactory

String

Sorties

PSDataset

Notes

  • Mots clés : azure, azurerm, arm, resource, management, manager, data, fabriques