Dataflows - Save Dataflow Gen One As Dataflow Gen Two

Служба:
Power BI REST APIs
Версия API:
v1.0

Сохранение потока данных 1-го поколения в виде потока данных 2-го поколения (CI/CD) (предварительная версия)
Преобразует поток данных 1-го поколения в собственный артефакт Fabric (CI/CD 2-го поколения).

Ключевые функции:

  • Создает новый артефакт 2-го поколения (CI/CD) при сохранении исходного потока данных 1-го поколения
  • При необходимости выполняет миграцию расписаний обновления
  • Обновляет форматы подключений в форматы, совместимые с Fabric
  • Сохранение меток конфиденциальности и параметров безопасности
  • Предоставляет подробные отчеты об ошибках для неустранимых проблем
  • Поддерживает указание целевой рабочей области для нового артефакта

Необходимые условия:

  • Исходный поток данных должен быть поколением 1
  • У пользователя должны быть соответствующие разрешения в рабочей области

Процесс миграции:

  1. Проверяет поток данных источника и разрешения
  2. Преобразует определение потока данных в формат Fabric
  3. Обновляет строки подключения для совместимости Fabric
  4. Создает новый артефакт 2-го поколения в указанной рабочей области
  5. При необходимости выполняет миграцию расписания обновления

Обработка ошибок: API возвращает успешное выполнение, даже если некоторые некритичные операции завершаются сбоем (например, планирование миграции). Такие сбои сообщаются в errors массиве ответа.

Preview

Это вызов API предварительной версии.

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

Параметры URI

Имя В Обязательно Тип Описание
gen1DataflowId
 path True

string (uuid)

Идентификатор объекта потока данных 1-го поколения для сохранения в виде собственного артефакта
groupId
 path True

string (uuid)

Идентификатор рабочей области (группы) потока данных 1-го поколения

Текст запроса

Имя Тип Описание
description

string

maxLength: 4000

Необязательное описание нового артефакта. Если он не указан или не указан, будет скопировано описание из исходного потока данных.

Максимальная длина: 4000 символов
displayName

string

maxLength: 200

Необязательное отображаемое имя нового артефакта. Если он не указан или не указан, система создаст имя на основе имени исходного потока данных с суффиксом, например "_copy1", "_copy2" и т. д., чтобы избежать конфликтов именования.

Максимальная длина: 200 символов
includeSchedule

boolean

Следует ли включить расписание обновления из исходного потока данных в миграцию. Если значение true, пытается скопировать существующее расписание в новое артефакт в отключенном состоянии. Если значение false, новый артефакт будет создан без расписания.
targetWorkspaceId

string (uuid)

Необязательный идентификатор целевой рабочей области, в котором будет создан новый артефакт. Если он не указан или не указан, новый артефакт будет создан в той же рабочей области, что и исходный поток данных.

Ответы

Имя Тип Описание
200 OK

SaveAsNativeDataflowResponse

ХОРОШО

Примеры

Example

Образец запроса

POST https://api.powerbi.com/v1.0/myorg/groups/51e47fc5-48fd-4826-89f0-021bd3a80abd/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/saveAsNativeArtifact
Текст запроса
{
  "displayName": "newDataflowName",
  "description": "New dataflow description",
  "includeSchedule": "true",
  "targetWorkspaceId": "d4c3b4a1-2f5e-4c3a-9f7e-123456789abc"
}

Пример ответа

Код состояния:
200
Код состояния:
400

Определения

Имя Описание
ArtifactMetadata

Сведения о метаданных артефакта Fabric
ArtifactMetadataUser

Сведения о пользователе в метаданных артефактов
ArtifactProvisionState

Текущее состояние подготовки артефакта
SaveAsNativeDataflowErrorCode

Неустранимые коды предупреждений, которые могут возникать во время миграции. Они указывают на частичные сбои, которые не препятствуют успешному выполнению общей операции.
SaveAsNativeDataflowRequest

Текст запроса на перенос потока данных 1-го поколения в собственный артефакт CI/CD 2-го поколения
SaveAsNativeDataflowResponse

Ответ от операции миграции потока данных

ArtifactMetadata

Объект

Сведения о метаданных артефакта Fabric

Имя Тип Описание
artifactType

string

Тип артефакта
capacityObjectId

string (uuid)

Идентификатор емкости, в котором размещен этот артефакт
createdByUser

ArtifactMetadataUser

Сведения о пользователе в метаданных артефактов
createdDate

string (date-time)

При создании артефакта
description

string

Описание артефакта
displayName

string

Отображаемое имя артефакта
folderObjectId

string (uuid)

Идентификатор рабочей области или папки, содержащей этот артефакт
lastUpdatedDate

string (date-time)

После последнего обновления артефакта
modifiedByUser

ArtifactMetadataUser

Сведения о пользователе в метаданных артефактов
objectId

string (uuid)

Уникальный идентификатор артефакта
ownerUser

ArtifactMetadataUser

Сведения о пользователе в метаданных артефактов
provisionState

ArtifactProvisionState

Текущее состояние подготовки артефакта
workloadPayload

string

Полезные данные для конкретной рабочей нагрузки

ArtifactMetadataUser

Объект

Сведения о пользователе в метаданных артефактов

Имя Тип Описание
displayName

string

Отображаемое имя пользователя
emailAddress

string (email)

Адрес электронной почты пользователя
objectId

string (uuid)

Идентификатор объекта пользователя

ArtifactProvisionState

Перечисление

Текущее состояние подготовки артефакта

Значение Описание
InProgress

Артефакт подготавливается
Active

Артефакт активен
Migrating

Артефакт переносится
Recovering

Артефакт восстанавливается
SoftDeletedByUser

Артефакт обратимо удаляется пользователем
SoftDeleted

Артефакт обратимо удален
Failed

Сбой подготовки артефакта
Deleting

Артефакт удаляется
DisabledByDeprovisioning

Артефакт отключен путем отмены подготовки
DeprovisioningFailed

Сбой депровидирования артефакта
DeletedByDeprovision

Артефакт удаляется путем отмены подготовки
DeletedByWorkload

Артефакт удаляется рабочей нагрузкой

SaveAsNativeDataflowErrorCode

Перечисление

Неустранимые коды предупреждений, которые могут возникать во время миграции. Они указывают на частичные сбои, которые не препятствуют успешному выполнению общей операции.

Значение Описание
FailedToCopySchedule

Не удалось скопировать расписание обновления в новый артефакт
SetDataflowOriginFailed

Не удалось задать сведения об отслеживании источника для нового артефакта
ConnectionsUpdateFailed

Не удалось обновить строки подключения до формата Fabric

SaveAsNativeDataflowRequest

Объект

Текст запроса на перенос потока данных 1-го поколения в собственный артефакт CI/CD 2-го поколения

Имя Тип Описание
description

string

maxLength: 4000

Необязательное описание нового артефакта. Если он не указан или не указан, будет скопировано описание из исходного потока данных.

Максимальная длина: 4000 символов
displayName

string

maxLength: 200

Необязательное отображаемое имя нового артефакта. Если он не указан или не указан, система создаст имя на основе имени исходного потока данных с суффиксом, например "_copy1", "_copy2" и т. д., чтобы избежать конфликтов именования.

Максимальная длина: 200 символов
includeSchedule

boolean

Следует ли включить расписание обновления из исходного потока данных в миграцию. Если значение true, пытается скопировать существующее расписание в новое артефакт в отключенном состоянии. Если значение false, новый артефакт будет создан без расписания.
targetWorkspaceId

string (uuid)

Необязательный идентификатор целевой рабочей области, в котором будет создан новый артефакт. Если он не указан или не указан, новый артефакт будет создан в той же рабочей области, что и исходный поток данных.

SaveAsNativeDataflowResponse

Объект

Ответ от операции миграции потока данных

Имя Тип Описание
artifactMetadata

ArtifactMetadata

Полные метаданные только что созданного артефакта 2-го поколения (CI/CD)
errors

SaveAsNativeDataflowErrorCode[]

Список неустранимых ошибок, произошедших во время процесса миграции. Миграция считается успешной, даже если возникают эти ошибки, но некоторые функции, возможно, не были перенесены должным образом.