Partager via

New-AzDataFactoryDataset

Module:
Az.DataFactory Module

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

Syntaxe

ByFactoryName (Par défaut) 

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

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 des 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, tapez Get-Help Format-List.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSDataFactory
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByFactoryObject
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByFactoryName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-File

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByFactoryName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSDataFactory

String

Sorties

PSDataset

Notes

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