Udostępnij przez

OneLake Shortcuts - Create Shortcut

Usługa:
Core
Wersja interfejsu API:
v1

Tworzy nowy skrót lub aktualizuje istniejący skrót.

Wymagane zakresy delegowane

OneLake.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

Ten interfejs API obsługuje tożsamości firmy Microsoft wymienione w tej sekcji.

Tożsamość Wsparcie
Użytkownik Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts
Z parametrami opcjonalnymi: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts?shortcutConflictPolicy={shortcutConflictPolicy}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
itemId
 path True

string (uuid)

Identyfikator elementu danych.
workspaceId
 path True

string (uuid)

Identyfikator obszaru roboczego.
shortcutConflictPolicy
 query

ShortcutConflictPolicy

Po podaniu definiuje akcję do wykonania, gdy skrót o tej samej nazwie i ścieżce już istnieje. Domyślną akcją jest "Abort". Dodatkowe typy ShortcutConflictPolicy mogą być dodawane w czasie.

Treść żądania

Nazwa Wymagane Typ Opis
name True

string

Nazwa skrótu.
path True

string

Ciąg reprezentujący pełną ścieżkę, w której jest tworzony skrót, w tym "Pliki" lub "Tabele".
target True

CreatableShortcutTarget

Obiekt, który zawiera docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych: OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3 zgodne, Dataverse, Azure Blob Storage lub OneDrive SharePoint.

Odpowiedzi

Nazwa Typ Opis
200 OK

Shortcut

Pomyślnie zaktualizowano.

Nagłówki

Location: string
201 Created

Shortcut

Pomyślnie utworzono.

Nagłówki

Location: string
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • ItemNotFound — serwer nie może odnaleźć żądanego elementu.

  • UnknownError — wystąpił błąd.

Przykłady

Create or update shortcut target to OneLake
Create shortcut AdlsGen2 target example
Create shortcut AmazonS3 target example
Create shortcut Azure Blob Storage target example
Create shortcut Google Cloud Storage target example
Create shortcut One Lake target example
Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example
Create shortcut S3 Compatible target example
Update shortcut target to OneLake

Create or update shortcut target to OneLake

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
200 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut AdlsGen2 target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/PartnerProducts
{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "type": "AdlsGen2",
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

Create shortcut AmazonS3 target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/PartnerEmployees
{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "type": "AmazonS3",
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

Create shortcut Azure Blob Storage target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts

{
  "path": "Files",
  "name": "MyAzureBlobStorage",
  "target": {
    "azureBlobStorage": {
      "location": "https://azureblobstoragetesting.blob.core.windows.net",
      "subpath": "/tables",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts/Files/MyAzureBlobStorage
{
  "path": "Files",
  "name": "MyAzureBlobStorage",
  "target": {
    "type": "AzureBlobStorage",
    "azureBlobStorage": {
      "location": "https://azureblobstoragetesting.blob.core.windows.net",
      "subpath": "/tables",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Create shortcut Google Cloud Storage target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/MyGCSShortcut1
{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "type": "GoogleCloudStorage",
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Create shortcut One Lake target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts

{
  "path": "Files",
  "name": "MyOneDriveSharePoint",
  "target": {
    "oneDriveSharePoint": {
      "location": "https://microsoft.sharepoint.com",
      "subpath": "/Shared Documents/Test Folder",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts/Files/MyOneDriveSharePoint
{
  "path": "Files",
  "name": "MyOneDriveSharePoint",
  "target": {
    "type": "OneDriveSharePoint",
    "oneDriveSharePoint": {
      "location": "https://microsoft.sharepoint.com",
      "subpath": "/Shared Documents/Test Folder",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Create shortcut S3 Compatible target example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/MyS3CompatibleShortcut1
{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "type": "S3Compatible",
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Update shortcut target to OneLake

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Przykładowa odpowiedź

Kod stanu:
200 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Definicje

Nazwa Opis
AdlsGen2

Obiekt zawierający właściwości docelowego źródła danych usługi ADLS Gen2.
AmazonS3

Obiekt zawierający właściwości docelowego źródła danych Amazon S3.
AzureBlobStorage

Obiekt zawierający właściwości docelowego źródła danych usługi Azure Blob Storage.
CreatableShortcutTarget

Obiekt zawierający docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych zgodnie z opisem w poniższej tabeli.
CreateShortcutRequest

Żądanie utworzenia skrótu z obiektem reprezentującym odwołanie do innej lokalizacji magazynu.
CsvToDeltaTransform

Przekształcanie woluminów CSV do funkcji delta.
CsvToDeltaTransformProperties

Właściwości przekształcenia csv na delta.
Dataverse

Obiekt zawierający właściwości docelowego źródła danych Dataverse.
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
ExternalDataShareTarget

Obiekt zawierający właściwości docelowego udziału danych zewnętrznych.
GoogleCloudStorage

Obiekt zawierający właściwości docelowego źródła danych usługi Google Cloud Storage.
OneDriveSharePoint

Obiekt zawierający właściwości docelowego źródła danych usługi OneDrive dla Firm lub SharePoint Online.
OneLake

Obiekt zawierający właściwości docelowego źródła danych OneLake.
S3Compatible

Obiekt zawierający właściwości docelowego źródła danych zgodnego z usługą S3.
Shortcut

Obiekt reprezentujący odwołanie wskazujące inne lokalizacje magazynu, które mogą być wewnętrzne lub zewnętrzne dla usługi OneLake. Skrót jest definiowany przez nazwę, ścieżkę, w której jest tworzony skrót i element docelowy określający docelową lokalizację magazynu.
ShortcutConflictPolicy

Po podaniu definiuje akcję do wykonania, gdy skrót o tej samej nazwie i ścieżce już istnieje. Domyślną akcją jest "Abort". Dodatkowe typy ShortcutConflictPolicy mogą być dodawane w czasie.
Target

Obiekt zawierający docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych zgodnie z opisem w poniższej tabeli.
Type

Obiekt type zawiera właściwości, takie jak typ konta skrótu docelowego. Dodatkowe typy mogą być dodawane w czasie.

AdlsGen2

Objekt

Obiekt zawierający właściwości docelowego źródła danych usługi ADLS Gen2.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych. Aby znaleźć ten identyfikator połączenia, najpierw utwórz połączenie w chmurze , które ma być używane przez skrót podczas nawiązywania połączenia z lokalizacją danych usługi ADLS. Otwórz widok Ustawienia połączenia w chmurze i skopiuj identyfikator połączenia; jest to identyfikator GUID.
location

string (uri)

Określa lokalizację docelowego kontenera usługi ADLS. Identyfikator URI musi być w formacie https://[nazwa-konta].dfs.core.windows.net, gdzie [account-name] jest nazwą docelowego konta usługi ADLS.
subpath

string

Określa kontener i podfolder w ramach konta usługi ADLS, w którym znajduje się folder docelowy. Musi mieć format [kontener]/[podfolder], gdzie [kontener] jest nazwą kontenera, który przechowuje pliki i foldery; [podfolder] to nazwa podfolderu w kontenerze (opcjonalnie). Na przykład: /mycontainer/mysubfolder

AmazonS3

Objekt

Obiekt zawierający właściwości docelowego źródła danych Amazon S3.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych. Aby znaleźć ten identyfikator połączenia, najpierw utwórz połączenie w chmurze , które ma być używane przez skrót podczas nawiązywania połączenia z lokalizacją danych amazon S3. Otwórz widok Ustawienia połączenia w chmurze i skopiuj identyfikator połączenia; jest to identyfikator GUID.
location

string (uri)

Adres URL HTTP wskazujący zasobnik docelowy w usłudze S3. Adres URL powinien mieć format https://[nazwa-zasobnika].s3. [region-code].amazonaws.com, gdzie "bucket-name" jest nazwą zasobnika S3, do którego chcesz wskazać, a "region-code" to kod regionu, w którym znajduje się zasobnik. Na przykład: https://my-s3-bucket.s3.us-west-2.amazonaws.com
subpath

string

Określa folder docelowy lub podfolder w zasobniku S3.

AzureBlobStorage

Objekt

Obiekt zawierający właściwości docelowego źródła danych usługi Azure Blob Storage.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych. Aby znaleźć ten identyfikator połączenia, najpierw utwórz połączenie w chmurze , które ma być używane przez skrót podczas nawiązywania połączenia z lokalizacją danych usługi Azure Blob Storage. Otwórz widok ustawień połączenia w chmurze i skopiuj identyfikator GUID, który jest identyfikatorem połączenia.
location

string (uri)

Określa lokalizację docelowego kontenera usługi Azure Blob Storage. Identyfikator URI musi być w formacie https://[account-name].blob.core.windows.net , w którym [account-name] jest nazwą docelowego konta usługi Azure Blob Storage.
subpath

string

Określa kontener i podfolder na koncie usługi Azure Blob Storage, w którym znajduje się folder docelowy. Musi mieć format [kontener]/[podfolder]. [Kontener] to nazwa kontenera, który przechowuje pliki i foldery. [Podfolder] to nazwa podfolderu w kontenerze i jest opcjonalna. Na przykład: /mycontainer/mysubfolder

CreatableShortcutTarget

Objekt

Obiekt zawierający docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych zgodnie z opisem w poniższej tabeli.

Nazwa Typ Opis
adlsGen2

AdlsGen2

Obiekt zawierający właściwości docelowego źródła danych usługi ADLS Gen2.
amazonS3

AmazonS3

Obiekt zawierający właściwości docelowego źródła danych Amazon S3.
azureBlobStorage

AzureBlobStorage

Obiekt zawierający właściwości docelowego źródła danych usługi Azure Blob Storage.
dataverse

Dataverse

Obiekt zawierający właściwości docelowego źródła danych Dataverse.
googleCloudStorage

GoogleCloudStorage

Obiekt zawierający właściwości docelowego źródła danych usługi Google Cloud Storage.
oneDriveSharePoint

OneDriveSharePoint

Obiekt zawierający właściwości docelowego źródła danych usługi OneDrive dla Firm i sharePoint Online.
oneLake

OneLake

Obiekt zawierający właściwości docelowego źródła danych OneLake.
s3Compatible

S3Compatible

Obiekt zawierający właściwości docelowego źródła danych zgodnego z usługą S3.

CreateShortcutRequest

Objekt

Żądanie utworzenia skrótu z obiektem reprezentującym odwołanie do innej lokalizacji magazynu.

Nazwa Typ Opis
name

string

Nazwa skrótu.
path

string

Ciąg reprezentujący pełną ścieżkę, w której jest tworzony skrót, w tym "Pliki" lub "Tabele".
target

CreatableShortcutTarget

Obiekt, który zawiera docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych: OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3 zgodne, Dataverse, Azure Blob Storage lub OneDrive SharePoint.

CsvToDeltaTransform

Objekt

Przekształcanie woluminów CSV do funkcji delta.

Nazwa Typ Opis
properties

CsvToDeltaTransformProperties

Właściwości przekształcenia csv do funkcji delta.
type string:

csvToDelta

Typ przekształcenia. Dodatkowe typy przekształceń można dodawać w czasie.

CsvToDeltaTransformProperties

Objekt

Właściwości przekształcenia csv na delta.

Nazwa Typ Domyślna wartość Opis
delimiter

string

,

Określa znak używany do oddzielania wartości w wierszu w pliku CSV i musi określić dokładnie jedną z obsługiwanych wartości: ,, , \t, |, &;. Wartość domyślna to ,.
skipFilesWithErrors

boolean

True

Czy pominąć pliki z błędami. True — pomijanie plików z błędami, Fałsz — nie pomijaj plików z błędami. Domyślna wartość to Prawda.
useFirstRowAsHeader

boolean

True

Czy pierwszy wiersz pliku CSV powinien być używany jako nagłówek. True — użyj pierwszego wiersza jako nagłówka. Fałsz — nie używaj pierwszego wiersza jako nagłówka. Domyślna wartość to Prawda.

Dataverse

Objekt

Obiekt zawierający właściwości docelowego źródła danych Dataverse.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych. Aby znaleźć ten identyfikator połączenia, najpierw utwórz połączenie w chmurze , które ma być używane przez skrót podczas nawiązywania połączenia z lokalizacją danych usługi Dataverse. Otwórz widok Ustawienia połączenia w chmurze i skopiuj identyfikator połączenia; jest to identyfikator GUID.
deltaLakeFolder

string

Określa ścieżkę folderu DeltaLake, w której są przechowywane dane docelowe.
environmentDomain

string (uri)

Identyfikator URI wskazujący nazwę domeny środowiska docelowego usługi Dataverse. Identyfikator URI powinien być sformatowany jako "https://[nazwa organizacji].crm[xx].dynamics.com", gdzie [orgname] reprezentuje nazwę organizacji usługi Dataverse.
tableName

string

Określa nazwę tabeli docelowej w usłudze Dataverse

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

ExternalDataShareTarget

Objekt

Obiekt zawierający właściwości docelowego udziału danych zewnętrznych.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych.

GoogleCloudStorage

Objekt

Obiekt zawierający właściwości docelowego źródła danych usługi Google Cloud Storage.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych.
location

string (uri)

Adres URL HTTP wskazujący zasobnik docelowy w usłudze GCS. Adres URL powinien mieć format https://[nazwa-zasobnika].storage.googleapis.com, gdzie [nazwa-zasobnika] jest nazwą zasobnika, który chcesz wskazać. Na przykład: https://my-gcs-bucket.storage.googleapis.com
subpath

string

Określa folder docelowy lub podfolder w zasobniku GCS. Na przykład: /folder

OneDriveSharePoint

Objekt

Obiekt zawierający właściwości docelowego źródła danych usługi OneDrive dla Firm lub SharePoint Online.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych. Aby znaleźć ten identyfikator połączenia, najpierw utwórz połączenie w chmurze , które ma być używane przez skrót podczas nawiązywania połączenia z lokalizacją danych programu SharePoint w usłudze OneDrive. Otwórz widok ustawień połączenia w chmurze i skopiuj identyfikator GUID, który jest identyfikatorem połączenia.
location

string (uri)

Określa lokalizację docelowego kontenera programu SharePoint w usłudze OneDrive. Identyfikator URI musi być w formacie https://microsoft.sharepoint.com , który jest ścieżką docelowego konta programu SharePoint w usłudze OneDrive.
subpath

string

Określa kontener i podfolder w ramach konta programu SharePoint usługi OneDrive, w którym znajduje się folder docelowy. Musi mieć format [kontener]/[podfolder]. [Kontener] to nazwa kontenera, który przechowuje pliki i foldery. [Podfolder] to nazwa podfolderu w kontenerze i jest opcjonalna. Na przykład: /mycontainer/mysubfolder

OneLake

Objekt

Obiekt zawierający właściwości docelowego źródła danych OneLake.

Nazwa Typ Opis
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych. Aby znaleźć ten identyfikator połączenia, najpierw utwórz połączenie w chmurze , które ma być używane przez skrót podczas nawiązywania połączenia z lokalizacją danych amazon S3. Otwórz widok Ustawienia połączenia w chmurze i skopiuj identyfikator połączenia; jest to identyfikator GUID.
itemId

string (uuid)

Identyfikator obiektu docelowego w usłudze OneLake. Obiektem docelowym może być element Lakehouse, KQLDatabase lub Warehouse.
path

string

Ciąg reprezentujący pełną ścieżkę do folderu docelowego w elemencie Item. Ta ścieżka powinna być względna względem katalogu głównego struktury katalogów OneLake. Na przykład: "Tables/myTablesFolder/someTableSubFolder".
workspaceId

string (uuid)

Identyfikator docelowego obszaru roboczego.

S3Compatible

Objekt

Obiekt zawierający właściwości docelowego źródła danych zgodnego z usługą S3.

Nazwa Typ Opis
bucket

string

Określa zasobnik docelowy w lokalizacji zgodnej z usługą S3.
connectionId

string (uuid)

Parametry reprezentujące połączenie powiązane ze skrótem. ConnectionId to unikatowy identyfikator używany do nawiązywania połączenia między skrótem a docelowym źródłem danych.
location

string (uri)

Adres URL HTTP punktu końcowego zgodnego z usługą S3. Ten punkt końcowy musi mieć możliwość odbierania wywołań interfejsu API ListBuckets S3. Adres URL musi być w formacie specyficznym dla zasobnika; w tym miejscu nie należy określać zasobnika. Na przykład: https://s3endpoint.contoso.com
subpath

string

Określa folder docelowy lub podfolder w zasobniku zgodnym z usługą S3. Na przykład: /folder

Shortcut

Objekt

Obiekt reprezentujący odwołanie wskazujące inne lokalizacje magazynu, które mogą być wewnętrzne lub zewnętrzne dla usługi OneLake. Skrót jest definiowany przez nazwę, ścieżkę, w której jest tworzony skrót i element docelowy określający docelową lokalizację magazynu.

Nazwa Typ Opis
name

string

Nazwa skrótu.
path

string

Ciąg reprezentujący pełną ścieżkę, w której jest tworzony skrót, w tym "Pliki" lub "Tabele".
target

Target

Obiekt zawierający docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych.
transform Transform:

CsvToDeltaTransform

Obiekt, który zawiera nazwę przekształcenia i odpowiadające jej właściwości, które mają być stosowane do danych docelowych, i musi określić dokładnie jedną z obsługiwanych przekształceń.

ShortcutConflictPolicy

Wyliczenie

Po podaniu definiuje akcję do wykonania, gdy skrót o tej samej nazwie i ścieżce już istnieje. Domyślną akcją jest "Abort". Dodatkowe typy ShortcutConflictPolicy mogą być dodawane w czasie.

Wartość Opis
Abort

Gdy skrót o tej samej nazwie i ścieżce już istnieje, tworzenie skrótu zostanie anulowane.
GenerateUniqueName

Gdy skrót o tej samej nazwie i ścieżce już istnieje, tworzenie skrótu będzie kontynuowane z nową unikatową nazwą skrótu.
CreateOrOverwrite

Gdy skrót o tej samej nazwie i ścieżce już istnieje, tworzenie skrótu spowoduje zastąpienie istniejącego skrótu. Utwórz skrót, jeśli nie istnieje.
OverwriteOnly

Gdy skrót o tej samej nazwie i ścieżce już istnieje, tworzenie skrótu spowoduje zastąpienie istniejącego skrótu.

Target

Objekt

Obiekt zawierający docelowe źródło danych i musi określić dokładnie jedno z obsługiwanych miejsc docelowych zgodnie z opisem w poniższej tabeli.

Nazwa Typ Opis
adlsGen2

AdlsGen2

Obiekt zawierający właściwości docelowego źródła danych usługi ADLS Gen2.
amazonS3

AmazonS3

Obiekt zawierający właściwości docelowego źródła danych Amazon S3.
azureBlobStorage

AzureBlobStorage

Obiekt zawierający właściwości docelowego źródła danych usługi Azure Blob Storage.
dataverse

Dataverse

Obiekt zawierający właściwości docelowego źródła danych Dataverse.
externalDataShare

ExternalDataShareTarget

Obiekt zawierający właściwości docelowego udziału danych zewnętrznych.
googleCloudStorage

GoogleCloudStorage

Obiekt zawierający właściwości docelowego źródła danych usługi Google Cloud Storage.
oneDriveSharePoint

OneDriveSharePoint

Obiekt zawierający właściwości docelowego źródła danych usługi OneDrive dla Firm i sharePoint Online.
oneLake

OneLake

Obiekt zawierający właściwości docelowego źródła danych OneLake.
s3Compatible

S3Compatible

Obiekt zawierający właściwości docelowego źródła danych zgodnego z usługą S3.
type

Type

Obiekt type zawiera właściwości, takie jak typ konta skrótu docelowego. Dodatkowe typy mogą być dodawane w czasie.

Type

Wyliczenie

Obiekt type zawiera właściwości, takie jak typ konta skrótu docelowego. Dodatkowe typy mogą być dodawane w czasie.

Wartość Opis
OneLake

OneLake
AmazonS3

AmazonS3
AdlsGen2

AdlsGen2
GoogleCloudStorage

GoogleCloudStorage
S3Compatible

Niezgodne S3
Dataverse

Dataverse
ExternalDataShare

ExternalDataShare
AzureBlobStorage

AzureBlobStorage
OneDriveSharePoint

OneDriveSharePoint