Dataflows - Save Dataflow Gen One As Dataflow Gen Two

Servizio:

Power BI REST APIs

Versione API:

v1.0

Salvare Dataflow Gen1 come Dataflow Gen2 (CI/CD) (anteprima)
Converte un flusso di dati Gen1 in un artefatto nativo di Fabric (CI/CD Gen2).

Funzionalità principali:

• Crea un nuovo artefatto Gen2 (CI/CD) mantenendo il flusso di dati Gen1 originale
• Facoltativamente, esegue la migrazione delle pianificazioni degli aggiornamenti
• Aggiorna i formati di connessione ai formati compatibili con Fabric
• Mantiene le etichette di riservatezza e le impostazioni di sicurezza
• Fornisce report dettagliati sugli errori per i problemi non irreversibili
• Supporta la specifica di un'area di lavoro di destinazione per il nuovo artefatto

Prerequisiti:

• Il flusso di dati di origine deve essere di prima generazione
• L'utente deve disporre delle autorizzazioni appropriate per l'area di lavoro

Processo di migrazione:

1. Convalida il flusso di dati di origine e le autorizzazioni
2. Converte la definizione del flusso di dati in formato Infrastruttura
3. Aggiorna le stringhe di connessione per la compatibilità di Fabric
4. Crea un nuovo artefatto Gen2 nell'area di lavoro specificata
5. Facoltativamente, esegue la migrazione della pianificazione dell'aggiornamento

Gestione degli errori: L'API restituisce esito positivo anche se alcune operazioni non critiche hanno esito negativo (ad esempio, pianificare la migrazione). Tali errori vengono segnalati nella errors matrice della risposta.

Preview

Si tratta di una chiamata API di anteprima.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows/{gen1DataflowId}/saveAsNativeArtifact

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
gen1DataflowId	path	True	string (uuid)	ID oggetto del flusso di dati Gen1 da salvare come artefatto nativo
groupId	path	True	string (uuid)	ID dell'area di lavoro (gruppo) del flusso di dati gen1

Corpo della richiesta

Nome	Tipo	Descrizione
description	string maxLength: 4000	Descrizione facoltativa per il nuovo artefatto. Se non viene specificato o vuoto, la descrizione del flusso di dati di origine verrà copiata. Lunghezza massima: 4000 caratteri
displayName	string maxLength: 200	Nome visualizzato facoltativo per il nuovo artefatto. Se non viene specificato o vuoto, il sistema genererà un nome basato sul nome del flusso di dati di origine con un suffisso come "_copy1", "_copy2" e così via per evitare conflitti di denominazione. Lunghezza massima: 200 caratteri
includeSchedule	boolean	Indica se includere la pianificazione dell'aggiornamento dal flusso di dati di origine nella migrazione. Se true, tenta di copiare la pianificazione esistente nel nuovo artefatto in stato disabilitato. Se false, il nuovo artefatto verrà creato senza una pianificazione.
targetWorkspaceId	string (uuid)	ID dell'area di lavoro di destinazione facoltativa in cui verrà creato il nuovo artefatto. Se non viene specificato o vuoto, il nuovo artefatto verrà creato nella stessa area di lavoro del flusso di dati di origine.

Risposte

Nome	Tipo	Descrizione
200 OK	SaveAsNativeDataflowResponse	Va bene

Esempio

Example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups/51e47fc5-48fd-4826-89f0-021bd3a80abd/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/saveAsNativeArtifact

Corpo della richiesta

{
  "displayName": "newDataflowName",
  "description": "New dataflow description",
  "includeSchedule": "true",
  "targetWorkspaceId": "d4c3b4a1-2f5e-4c3a-9f7e-123456789abc"
}

Risposta di esempio

Codice di stato:

200

Codice di stato:

400

Definizioni

Nome	Descrizione
ArtifactMetadata	Informazioni sui metadati per un artefatto dell'infrastruttura
ArtifactMetadataUser	Informazioni utente nei metadati degli artefatti
ArtifactProvisionState	Stato di provisioning corrente dell'artefatto
SaveAsNativeDataflowErrorCode	Codici di avviso non irreversibili che possono verificarsi durante la migrazione. Questi indicano errori parziali che non impediscono l'esito positivo dell'operazione complessiva.
SaveAsNativeDataflowRequest	Corpo della richiesta per la migrazione di un flusso di dati Gen1 a Gen2 (CI/CD) elemento nativo
SaveAsNativeDataflowResponse	Risposta dall'operazione di migrazione del flusso di dati

ArtifactMetadata

Oggetto

Informazioni sui metadati per un artefatto dell'infrastruttura

Nome	Tipo	Descrizione
artifactType	string	Tipo dell'artefatto
capacityObjectId	string (uuid)	ID della capacità che ospita questo artefatto
createdByUser	ArtifactMetadataUser	Informazioni utente nei metadati degli artefatti
createdDate	string (date-time)	Quando è stato creato l'artefatto
description	string	Descrizione dell'artefatto
displayName	string	Nome visualizzato dell'artefatto
folderObjectId	string (uuid)	ID dell'area di lavoro/cartella contenente questo artefatto
lastUpdatedDate	string (date-time)	Data dell'ultimo aggiornamento dell'artefatto
modifiedByUser	ArtifactMetadataUser	Informazioni utente nei metadati degli artefatti
objectId	string (uuid)	Identificatore univoco per l'artefatto
ownerUser	ArtifactMetadataUser	Informazioni utente nei metadati degli artefatti
provisionState	ArtifactProvisionState	Stato di provisioning corrente dell'artefatto
workloadPayload	string	Dati del payload specifici del carico di lavoro

ArtifactMetadataUser

Oggetto

Informazioni utente nei metadati degli artefatti

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'utente
emailAddress	string (email)	Indirizzo di posta elettronica dell'utente
objectId	string (uuid)	ID oggetto dell'utente

ArtifactProvisionState

Enumerazione

Stato di provisioning corrente dell'artefatto

Valore	Descrizione
InProgress	Provisioning dell'artefatto
Active	L'artefatto è attivo
Migrating	L'artefatto viene migrato
Recovering	L'artefatto sta recuperando
SoftDeletedByUser	L'artefatto viene eliminato softmente dall'utente
SoftDeleted	L'artefatto viene eliminato leggero
Failed	Provisioning dell'artefatto non riuscito
Deleting	L'artefatto viene eliminato
DisabledByDeprovisioning	L'artefatto è disabilitato tramite il deprovisioning
DeprovisioningFailed	Il deprovisioning dell'artefatto non è riuscito
DeletedByDeprovision	L'artefatto viene eliminato tramite il deprovisioning
DeletedByWorkload	L'artefatto viene eliminato dal carico di lavoro

SaveAsNativeDataflowErrorCode

Enumerazione

Codici di avviso non irreversibili che possono verificarsi durante la migrazione. Questi indicano errori parziali che non impediscono l'esito positivo dell'operazione complessiva.

Valore	Descrizione
FailedToCopySchedule	Impossibile copiare la pianificazione dell'aggiornamento nel nuovo artefatto
SetDataflowOriginFailed	Impossibile impostare le informazioni di rilevamento dell'origine sul nuovo artefatto
ConnectionsUpdateFailed	Impossibile aggiornare le stringhe di connessione al formato fabric

SaveAsNativeDataflowRequest

Oggetto

Corpo della richiesta per la migrazione di un flusso di dati Gen1 a Gen2 (CI/CD) elemento nativo

Nome	Tipo	Descrizione
description	string maxLength: 4000	Descrizione facoltativa per il nuovo artefatto. Se non viene specificato o vuoto, la descrizione del flusso di dati di origine verrà copiata. Lunghezza massima: 4000 caratteri
displayName	string maxLength: 200	Nome visualizzato facoltativo per il nuovo artefatto. Se non viene specificato o vuoto, il sistema genererà un nome basato sul nome del flusso di dati di origine con un suffisso come "_copy1", "_copy2" e così via per evitare conflitti di denominazione. Lunghezza massima: 200 caratteri
includeSchedule	boolean	Indica se includere la pianificazione dell'aggiornamento dal flusso di dati di origine nella migrazione. Se true, tenta di copiare la pianificazione esistente nel nuovo artefatto in stato disabilitato. Se false, il nuovo artefatto verrà creato senza una pianificazione.
targetWorkspaceId	string (uuid)	ID dell'area di lavoro di destinazione facoltativa in cui verrà creato il nuovo artefatto. Se non viene specificato o vuoto, il nuovo artefatto verrà creato nella stessa area di lavoro del flusso di dati di origine.

SaveAsNativeDataflowResponse

Oggetto

Risposta dall'operazione di migrazione del flusso di dati

Nome	Tipo	Descrizione
artifactMetadata	ArtifactMetadata	Completare i metadati dell'artefatto Gen2(CI/CD) appena creato
errors	SaveAsNativeDataflowErrorCode[]	Elenco di errori non irreversibili che si sono verificati durante il processo di migrazione. La migrazione viene considerata riuscita anche se si verificano questi errori, ma alcune funzionalità potrebbero non essere state migrate correttamente.