Condividi tramite

New-AzureRmDataFactoryDataset

  • Riferimento
Modulo:
AzureRM.DataFactories

Crea un set di dati in Data Factory.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

New-AzureRmDataFactoryDataset
   [-DataFactoryName] <String>
   [[-Name] <String>]
   [-File] <String>
   [-Force]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmDataFactoryDataset
   [-DataFactory] <PSDataFactory>
   [[-Name] <String>]
   [-File] <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzureRmDataFactoryDataset crea un set di dati in Azure Data Factory. Se si specifica un nome per un set di dati già esistente, questo cmdlet richiede la conferma prima di sostituire il set di dati. Se si specifica il parametro Force , il cmdlet sostituisce il set di dati esistente senza confermare. Eseguire queste operazioni nell'ordine seguente:

  • Creare una data factory.
  • Creare servizi collegati.
  • Creare i set di dati.
  • Creare una pipeline. Se nella data factory esiste già un set di dati con lo stesso nome, questo cmdlet chiede di confermare se sovrascrivere il set di dati esistente con il nuovo set di dati. Se si conferma di sovrascrivere il set di dati esistente, viene sostituita anche la definizione del set di dati.

Esempio

Esempio 1: Creare un set di dati

PS C:\>New-AzureRmDataFactoryDataset -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         : {}

Questo comando crea un set di dati denominato DA_WikipediaClickEvents nella data factory denominata WikiADF. Il comando basa il set di dati sulle informazioni nel file DAWikipediaClickEvents.json.

Esempio 2: Visualizzare la disponibilità per un nuovo set di dati

PS C:\>$Dataset = New-AzureRmDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"
PS C:\> $Dataset.Availability
AnchorDateTime : 
Frequency      : Hour
Interval       : 1
Offset         : 
WaitOnExternal : Microsoft.DataFactories.WaitOnExternal

Il primo comando crea un set di dati denominato DA_WikipediaClickEvents, come in un esempio precedente, e quindi assegna tale set di dati alla variabile $Dataset. Il secondo comando usa la notazione punto standard per visualizzare i dettagli sulla proprietà Availability del set di dati.

Esempio 3: Visualizzare la posizione per un nuovo set di dati

PS C:\>$Dataset = New-AzureRmDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"
PS C:\> $Dataset.Location
BlobPath          : wikidatagateway/wikisampledatain/
FilenamePrefix    : 
Format            : 
LinkedServiceName : LinkedServiceWikipediaClickEvents
PartitionBy       : {}

Il primo comando crea un set di dati denominato DA_WikipediaClickEvents, come in un esempio precedente, e quindi assegna tale set di dati alla variabile $Dataset. Il secondo comando visualizza i dettagli sulla proprietà Location del set di dati.

Esempio 4: Visualizzare le regole di convalida per un nuovo set di dati

PS C:\>$Dataset = New-AzureRmDataFactoryDataset -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "DAWikipediaClickEvents" -File "C:\\samples\\WikiSample\\DA_WikipediaClickEvents.json"
PS C:\> $Dataset.Policy.Validation | Format-List $dataset.Location
BlobPath          : wikidatagateway/wikisampledatain/
FilenamePrefix    : 
Format            : 
LinkedServiceName : LinkedServiceWikipediaClickEvents
PartitionBy       : {}

MinimumRows   : 
MinimumSizeMB : 1

Il primo comando crea un set di dati denominato DA_WikipediaClickEvents, come in un esempio precedente, e quindi assegna tale set di dati alla variabile $Dataset. Il secondo comando ottiene informazioni dettagliate sulle regole di convalida per il set di dati e quindi le passa al cmdlet Format-List usando l'operatore pipeline. Questo cmdlet di Windows PowerShell formatta i risultati. Per ulteriori informazioni, digitare Get-Help Format-List.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DataFactory

Specifica un oggetto PSDataFactory . Questo cmdlet crea un set di dati nella data factory specificata da questo parametro.

Tipo:PSDataFactory
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DataFactoryName

Specifica il nome di una data factory. Questo cmdlet crea un set di dati nella data factory specificata da questo parametro.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-File

Specifica il percorso completo del file JSON (JavaScript Object Notation) che contiene la descrizione del set di dati.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che questo cmdlet sostituisce un set di dati esistente senza chiedere conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome del set di dati da creare.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il nome di un gruppo di risorse di Azure. Questo cmdlet crea un set di dati nel gruppo specificato da questo parametro.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSDataFactory

String

Output

PSDataset

Note

  • Parole chiave: azure, azurerm, arm, resource, management, manager, data, factory