Julkiset ohjelmointirajapinnat tietovoid Gen2:lle Fabric Data Factoryssa

Fabric Data Factory tarjoaa runsaasti ohjelmointirajapintoja, joiden avulla käyttäjät voivat automatisoida ja hallita tietovoitaan tehokkaasti. Nämä ohjelmointirajapinnat mahdollistavat saumattoman integroinnin eri tietolähteisiin ja palveluihin, jotta käyttäjät voivat luoda, päivittää ja seurata tietojen työnkulkujaan ohjelmallisesti. Ohjelmointirajapinnat tukevat useita erilaisia toimintoja, kuten tietovoiden CRUD-toimintoa (luonti, luku, päivitys ja poisto), ajoittamista ja seurantaa, mikä helpottaa käyttäjien tietojen integrointiprosessien hallintaa.

Ohjelmointirajapintojen tietovoiden käyttötapaukset

Fabric Data Factory -tietovoiden ohjelmointirajapintoja voidaan käyttää erilaisissa tilanteissa:

Automaattinen käyttöönotto: Automatisoi tietovoiden käyttöönotto eri ympäristöissä (kehitys, testaus, tuotanto) CI/CD-käytäntöjen avulla.
Valvonta ja hälytykset: Määritä automatisoituja valvonta- ja ilmoitusjärjestelmiä, joilla voit seurata tietovoiden tilaa ja vastaanottaa ilmoituksia virheiden tai suorituskykyongelmien varalta.
Tietojen integrointi: Integroi tiedot useista lähteistä, kuten tietokannoista, Data Lake -tallennusasemista ja pilvipalveluista, yhdistettyyn tietovuohon käsittelyä ja analysointia varten.
Virheenkäsittely: Ota käyttöön mukautetun virheenkäsittely- ja uudelleenyritysten mekanismit, joilla varmistat tietovoiden sujuvan ja palautumisen virheistä.

Ohjelmointirajapintojen ymmärtäminen

Jotta voit käyttää tietovoiden ohjelmointirajapintoja tehokkaasti Fabric Data Factoryssa, on tärkeää ymmärtää tärkeimmät käsitteet ja komponentit:

Päätepisteet: Ohjelmointirajapinnan päätepisteet mahdollistavat erilaisiin tietovuotoimintoihin, kuten tietovoiden luomisen, päivittämisen ja poistamisen.
Todentaminen: Ohjelmointirajapintojen suojattu käyttö todennusmekanismeilla, kuten OAuth- tai API-avaimilla.
Pyynnöt ja vastaukset: Ymmärrä API-pyyntöjen ja vastausten rakenne, mukaan lukien tarvittavat parametrit ja odotettu tuloste.
Korkorajoitukset: Ota huomioon ohjelmointirajapinnan käytölle asetetut hintarajoitukset, jotta vältyt sallittujen pyyntöjen määrän ylittämiseltä.

CRUD-tuki

CRUD tarkoittaa luonti-, luku-, päivitys- ja poistotoimintoja. Ne ovat neljä perustoimintoa, jotka tiedoille voidaan suorittaa. Fabric Data Factoryssa CRUD-toimintoja tuetaan Fabric API for Data Factoryn kautta. Näiden ohjelmointirajapintojen avulla käyttäjät voivat hallita tietovoitaan ohjelmallisesti. Tässä on joitakin CRUD-tuen pääkohtia:

Luo: Luo uusia tietovoita ohjelmointirajapinnan avulla. Tähän kuuluu tietovuon rakenteen määrittäminen sekä tietolähteiden, muunnosten ja kohteiden määrittäminen.
Lue: nouda tietoja olemassa olevista tietovoista. Tämä sisältää tietoja niiden määrityksestä, tilasta ja suoritushistoriasta.
Päivitä: Päivitä olemassa olevat tietovuot. Tämä saattaa tarkoittaa tietovuon rakenteen muokkaamista, tietolähteiden muuttamista tai muunnoslogiikan päivittämistä.
Poista: Poista tietovuot, joita ei enää tarvita. Tämä auttaa resurssien hallinnassa ja puhdistamisessa.

Microsoft Fabric REST -ohjelmointirajapintojen ensisijaiset online-viitedokumentaatiot löytyvät Microsoft Fabricin REST-ohjelmointirajapinnan dokumentaatiosta.

Tietovuon elinkaari

Kun käsittelet tietovoita, on tärkeää ymmärtää tietovuon elinkaari, jotta voit varmistaa tasaiset ja tehokkaat tietojen integrointiprosessit. Tietovuon elinkaaren tärkeimpiä vaiheita ovat muun muassa seuraavat:

Määritelmä: Tämä on ensimmäinen vaihe, jossa luot tai muokkaat tietovuon määritystä. Tämä edellyttää tietolähteiden, muunnosten ja määritelmien määrittämistä.
Julkaista: Kun olet muokannut tietovuon määritystä, sinun on kutsuttava Julkaise-toiminto . Tämä on tärkeä vaihe, sillä se tallentaa tietovuon määritelmään tehdyt muutokset ja asettaa sen suoritettaviksi.
Virkistää: Kun tietovuo on julkaistu, voit käynnistää Päivitä-toiminnon . Tämä käynnistää tietovuon suorittamisen, tietojen vastaanottamisen määritetyistä lähteistä, määritettyjen muunnosten käyttöönoton ja tietojen lataamisen kohdesijainniin.

Tietovoiden julkisten ohjelmointirajapintojen käytön aloittaminen

Tässä osiossa käsittelemme kaikkia seuraavia aiheita:

Valtuutustunnuksen hankkiminen
Luo tietovuo
Luo tietovuo määrityksen avulla
Hae tietovuo
Hae tietovuo määrityksen kanssa
Päivitä tietovuo
Päivitä tietovuo määrityksellä
Poista tietovuo
Suorita pyydettäessä suoritettava tietovuotyö (päivitys)
Suorita pyydettäessä suoritettava tietovuon julkaisutyö
Nouda tietovuotyön esiintymä
Peruuta tietovuotyön esiintymä

Valtuutustunnuksen hankkiminen

Sinulla on oltava haltijatunnus kaikille REST-ohjelmointirajapinnan kutsuille, ja voit hankkia sen käyttämällä jotakin seuraavista vaihtoehdoista:

MSAL.Net
Fabric-portaali

MSAL.Net

Fabric-ohjelmointirajapinnan pika-aloitus – Microsoft Fabric REST -ohjelmointirajapinnat

hanki MSAL.Net avulla Microsoft Entra ID -tunnus Fabric-palvelulle käyttämällä seuraavia vaikutusalueita: Workspace.ReadWrite.All, Item.ReadWrite.All. Lisätietoja tunnuksen hankkimisesta MSAL.Net kohteeseen on kohdassa Tunnuksen hankinta – Microsoftin todentamiskirjasto .NET:lle.

Liitä aiemmin kopioimasi Sovellus (asiakas) -tunnus ja liitä se ClientId-muuttujaa varten.

Fabric-portaali

Kirjaudu testattavan vuokraajan Kangasportaaliin ja paina F12 siirtyäksesi selaimen kehittäjätilaan. Suorita konsolissa seuraava komento:

powerBIAccessToken

Kopioi tunnus ja liitä se ClientId-muuttujalle.

Luo tietovuo

Luo tietovuo määritettyyn työtilaan.

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items)

Headers:

{
    "Authorization": "\<bearer-token>",
    "Content-Type": "application/json"
}

Payload:

{
    "displayName": "My dataflow",
    "description": "My dataflow description",
    "type": "Dataflow"
}

mallivastauksen

{
    "id": "\<itemId>",
    "type": "Dataflow",
    "displayName": "My dataflow",
    "description": "My dataflow description",
    "workspaceId": "\<workspaceId>"
}

Luo tietovuo määrityksen avulla

Luo tiettyyn työtilaan tietovuo, jolla on Base64-määritys.

Esimerkki koosteasiakirjasta

{
    "editingSessionMashup": {
            "mashupName": "",
            "mashupDocument": "section Section1;\r\nshared Query = let\n Source = Table.FromRows(\n {\n {1, \"Bob\", \"123-4567\"},\n {2, \"Jim\", \"987-6543\"}\n },\n {\"CustomerID\", \"Name\", \"Phone\"})\nin\n Source;\r\n",
            "queryGroups": [],
            "documentLocale": "en-US",
            "gatewayObjectId": null,
            "queriesMetadata": null,
            "connectionOverrides": [],
            "trustedConnections": null,
            "useHostConnectionProvider": false,
            "fastCombine": false,
            "allowNativeQueries": true,
            "allowedModules": null,
            "skipAutomaticTypeAndHeaderDetection": false,
            "disableAutoAnonymousConnectionUpsert": null,
            "hostProperties": {
                    "DataflowRefreshOutputFileFormat": "Parquet",
                    "EnableDateTimeFieldsForStaging": "true",
                    "EnablePublishWithoutLoadedQueries": "true"
            },
            "defaultOutputDestinationConfiguration": null,
            "stagingDefinition": null
    }
}

Käytä Base64-koodausta ja decodea JSON-koodaamiseen.

Varmista, että Suorita URL-osoite turvallinen koodaus -ruutu ei ole valittuna.

Liitä koodatun Base64-pyynnön vastaus hyötykuorman määritelmään

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items)

Headers:

{
    "Authorization": "\<bearer-token>",
    "Content-Type": "application/json"
}

Payload:

{
    "displayName": " My dataflow",
    "description": "My dataflow description",

    "type": "Dataflow",
    "definition": {  
        "parts": [  
            {  
                "path": "dataflow-content.json",  
                "payload": "ewogICAgImVkaXRpbmdTZXNzaW9uTWFzaHVwIjogewogICAgICAgICJtYXNodXBOYW1lIjogIiIsCiAgICAgICAgIm1hc2h1cERvY3VtZW50IjogInNlY3Rpb24gU2VjdGlvbjE7XHJcbnNoYXJlZCBRdWVyeSA9IGxldFxuIFNvdXJjZSA9IFRhYmxlLkZyb21Sb3dzKFxuIHtcbiB7MSwgXCJCb2JcIiwgXCIxMjMtNDU2N1wifSxcbiB7MiwgXCJKaW1cIiwgXCI5ODctNjU0M1wifVxuIH0sXG4ge1wiQ3VzdG9tZXJJRFwiLCBcIk5hbWVcIiwgXCJQaG9uZVwifSlcbmluXG4gU291cmNlO1xyXG4iLAogICAgICAgICJxdWVyeUdyb3VwcyI6IFtdLAogICAgICAgICJkb2N1bWVudExvY2FsZSI6ICJlbi1VUyIsCiAgICAgICAgImdhdGV3YXlPYmplY3RJZCI6IG51bGwsCiAgICAgICAgInF1ZXJpZXNNZXRhZGF0YSI6IG51bGwsCiAgICAgICAgImNvbm5lY3Rpb25PdmVycmlkZXMiOiBbXSwKICAgICAgICAidHJ1c3RlZENvbm5lY3Rpb25zIjogbnVsbCwKICAgICAgICAidXNlSG9zdENvbm5lY3Rpb25Qcm92aWRlciI6IGZhbHNlLAogICAgICAgICJmYXN0Q29tYmluZSI6IGZhbHNlLAogICAgICAgICJhbGxvd05hdGl2ZVF1ZXJpZXMiOiB0cnVlLAogICAgICAgICJhbGxvd2VkTW9kdWxlcyI6IG51bGwsCiAgICAgICAgInNraXBBdXRvbWF0aWNUeXBlQW5kSGVhZGVyRGV0ZWN0aW9uIjogZmFsc2UsCiAgICAgICAgImRpc2FibGVBdXRvQW5vbnltb3VzQ29ubmVjdGlvblVwc2VydCI6IG51bGwsCiAgICAgICAgImhvc3RQcm9wZXJ0aWVzIjogewogICAgICAgICAgICAiRGF0YWZsb3dSZWZyZXNoT3V0cHV0RmlsZUZvcm1hdCI6ICJQYXJxdWV0IiwKICAgICAgICAgICAgIkVuYWJsZURhdGVUaW1lRmllbGRzRm9yU3RhZ2luZyI6ICJ0cnVlIiwKICAgICAgICAgICAgIkVuYWJsZVB1Ymxpc2hXaXRob3V0TG9hZGVkUXVlcmllcyI6ICJ0cnVlIgogICAgICAgIH0sCiAgICAgICAgImRlZmF1bHRPdXRwdXREZXN0aW5hdGlvbkNvbmZpZ3VyYXRpb24iOiBudWxsLAogICAgICAgICJzdGFnaW5nRGVmaW5pdGlvbiI6IG51bGwKICAgIH0KfQ==",
                "payloadType": "InlineBase64"  
            }  
        ]  
    }  
}

mallivastauksen

{
    "id": "\<itemId>",
    "type": "Dataflow",
    "displayName": "My dataflow",
    "description": "My dataflow description",
    "workspaceId": "\<workspaceId>"
}

Hae tietovuo

Palauttaa määritetyn tietovuon ominaisuudet.

Mallipyyntö

URI: GET [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d)

Headers:

{
    "Authorization": "\<bearer-token>"
}

mallivastauksen

{
    "id": "\<itemId>",
    "type": "Dataflow",
    "displayName": "My dataflow",
    "description": "My dataflow description",
    "workspaceId": "\<workspaceId>"
}

Hae tietovuo määrityksen kanssa

Palauttaa tietovuon kohteen määrityksen.

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/getDefinition](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d/getDefinition)

Headers:

{
    "Authorization": "\<bearer-token>"
}

mallivastauksen

{ 

    "definition": { 

        "parts": [ 

            { 

                "path": "dataflow-content.json", 

                "payload": " ewogICAgImVkaXRpbmdTZXNzaW9uTWFzaHVwIjogewogICAgICAgICJtYXNodXBOYW1lIjogIiIsCiAgICAgICAgIm1hc2h1cERvY3VtZW50IjogInNlY3Rpb24gU2VjdGlvbjE7XHJcbnNoYXJlZCBRdWVyeSA9IGxldFxuIFNvdXJjZSA9IFRhYmxlLkZyb21Sb3dzKFxuIHtcbiB7MSwgXCJCb2JcIiwgXCIxMjMtNDU2N1wifSxcbiB7MiwgXCJKaW1cIiwgXCI5ODctNjU0M1wifVxuIH0sXG4ge1wiQ3VzdG9tZXJJRFwiLCBcIk5hbWVcIiwgXCJQaG9uZVwifSlcbmluXG4gU291cmNlO1xyXG4iLAogICAgICAgICJxdWVyeUdyb3VwcyI6IFtdLAogICAgICAgICJkb2N1bWVudExvY2FsZSI6ICJlbi1VUyIsCiAgICAgICAgImdhdGV3YXlPYmplY3RJZCI6IG51bGwsCiAgICAgICAgInF1ZXJpZXNNZXRhZGF0YSI6IG51bGwsCiAgICAgICAgImNvbm5lY3Rpb25PdmVycmlkZXMiOiBbXSwKICAgICAgICAidHJ1c3RlZENvbm5lY3Rpb25zIjogbnVsbCwKICAgICAgICAidXNlSG9zdENvbm5lY3Rpb25Qcm92aWRlciI6IGZhbHNlLAogICAgICAgICJmYXN0Q29tYmluZSI6IGZhbHNlLAogICAgICAgICJhbGxvd05hdGl2ZVF1ZXJpZXMiOiB0cnVlLAogICAgICAgICJhbGxvd2VkTW9kdWxlcyI6IG51bGwsCiAgICAgICAgInNraXBBdXRvbWF0aWNUeXBlQW5kSGVhZGVyRGV0ZWN0aW9uIjogZmFsc2UsCiAgICAgICAgImRpc2FibGVBdXRvQW5vbnltb3VzQ29ubmVjdGlvblVwc2VydCI6IG51bGwsCiAgICAgICAgImhvc3RQcm9wZXJ0aWVzIjogewogICAgICAgICAgICAiRGF0YWZsb3dSZWZyZXNoT3V0cHV0RmlsZUZvcm1hdCI6ICJQYXJxdWV0IiwKICAgICAgICAgICAgIkVuYWJsZURhdGVUaW1lRmllbGRzRm9yU3RhZ2luZyI6ICJ0cnVlIiwKICAgICAgICAgICAgIkVuYWJsZVB1Ymxpc2hXaXRob3V0TG9hZGVkUXVlcmllcyI6ICJ0cnVlIgogICAgICAgIH0sCiAgICAgICAgImRlZmF1bHRPdXRwdXREZXN0aW5hdGlvbkNvbmZpZ3VyYXRpb24iOiBudWxsLAogICAgICAgICJzdGFnaW5nRGVmaW5pdGlvbiI6IG51bGwKICAgIH0KfQ==" 

                "payloadType": "InlineBase64" 

            }, 

            { 

                "path": ".platform", 

                "payload": "ewogICIkc2NoZW1hIjogImh0dHBzOi8vZGV2ZWxvcGVyLm1pY3Jvc29mdC5jb20vanNvbi1zY2hlbWFzL2ZhYnJpYy9naXRJbnRlZ3JhdGlvbi9wbGF0Zm9ybVByb3BlcnRpZXMvMi4wLjAvc2NoZW1hLmpzb24iLAogICJtZXRhZGF0YSI6IHsKICAgICJ0eXBlIjogIkRhdGFmbG93IiwKICAgICJkaXNwbGF5TmFtZSI6ICJEYXRhZmxvdyAzIgogIH0sCiAgImNvbmZpZyI6IHsKICAgICJ2ZXJzaW9uIjogIjIuMCIsCiAgICAibG9naWNhbElkIjogIjAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwLTAwMDAwMDAwMDAwMCIKICB9Cn0=", 

                "payloadType": "InlineBase64" 

            } 

        ] 

    } 

}

OHJELMOINTIRAJAPINNAN VASTAUS

{ 
    'definition':  
    { 
        'parts': [ 
            { 
                'path': 'queryMetadata.json', 'payload': '<super long entry>', 'payloadType': 'InlineBase64' 
            }, 
            { 
                'path': 'mashup.pq', 'payload': '<super long entry>', 'payloadType': 'InlineBase64' 
            }, 
            { 
                'path': '.platform', 'payload': '<super long entry>', 'payloadType': 'InlineBase64' 
            } 
        ] 
    } 
}

Päivitä tietovuo

Päivittää tietovuon ominaisuudet.

Mallipyyntö

URI: PATCH [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d)  

Headers: 

{ 
  "Authorization": "\<bearer-token>", 
  "Content-Type": "application/json" 
} 

Payload: 
{ 
  "displayName": "My dataflow updated", 
  "description": "My dataflow description updated", 
  "type": "Dataflow" 
}

mallivastauksen

{ 
    "id": "\<itemId>", 
    "type": "Dataflow", 
    "displayName": "My dataflow updated", 
    "description": "My dataflow description updated", 
    "workspaceId": "\<workspaceId>" 
}

Päivitä tietovuo määrityksellä

Päivittää tietovuon kohteen määrityksen.

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/updateDefinition](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d/updateDefinition) 

Headers: 

{ 
  "Authorization": "\<bearer-token>", 
  "Content-Type": "application/json" 
} 

Payload: 

{ 
  "displayName": " My dataflow", 
  "type": "Dataflow", 
  "definition": { 
    "parts": [  
      {  
        "path": "dataflow-content.json",  
        "payload": " ewogICAgImVkaXRpbmdTZXNzaW9uTWFzaHVwIjogewogICAgICAgICJtYXNodXBOYW1lIjogIiIsCiAgICAgICAgIm1hc2h1cERvY3VtZW50IjogInNlY3Rpb24gU2VjdGlvbjE7XHJcbnNoYXJlZCBRdWVyeSA9IGxldFxuIFNvdXJjZSA9IFRhYmxlLkZyb21Sb3dzKFxuIHtcbiB7MSwgXCJCb2JcIiwgXCIxMjMtNDU2N1wifSxcbiB7MiwgXCJKaW1cIiwgXCI5ODctNjU0M1wifVxuIH0sXG4ge1wiQ3VzdG9tZXJJRFwiLCBcIk5hbWVcIiwgXCJQaG9uZVwifSlcbmluXG4gU291cmNlO1xyXG4iLAogICAgICAgICJxdWVyeUdyb3VwcyI6IFtdLAogICAgICAgICJkb2N1bWVudExvY2FsZSI6ICJlbi1VUyIsCiAgICAgICAgImdhdGV3YXlPYmplY3RJZCI6IG51bGwsCiAgICAgICAgInF1ZXJpZXNNZXRhZGF0YSI6IG51bGwsCiAgICAgICAgImNvbm5lY3Rpb25PdmVycmlkZXMiOiBbXSwKICAgICAgICAidHJ1c3RlZENvbm5lY3Rpb25zIjogbnVsbCwKICAgICAgICAidXNlSG9zdENvbm5lY3Rpb25Qcm92aWRlciI6IGZhbHNlLAogICAgICAgICJmYXN0Q29tYmluZSI6IGZhbHNlLAogICAgICAgICJhbGxvd05hdGl2ZVF1ZXJpZXMiOiB0cnVlLAogICAgICAgICJhbGxvd2VkTW9kdWxlcyI6IG51bGwsCiAgICAgICAgInNraXBBdXRvbWF0aWNUeXBlQW5kSGVhZGVyRGV0ZWN0aW9uIjogZmFsc2UsCiAgICAgICAgImRpc2FibGVBdXRvQW5vbnltb3VzQ29ubmVjdGlvblVwc2VydCI6IG51bGwsCiAgICAgICAgImhvc3RQcm9wZXJ0aWVzIjogewogICAgICAgICAgICAiRGF0YWZsb3dSZWZyZXNoT3V0cHV0RmlsZUZvcm1hdCI6ICJQYXJxdWV0IiwKICAgICAgICAgICAgIkVuYWJsZURhdGVUaW1lRmllbGRzRm9yU3RhZ2luZyI6ICJ0cnVlIiwKICAgICAgICAgICAgIkVuYWJsZVB1Ymxpc2hXaXRob3V0TG9hZGVkUXVlcmllcyI6ICJ0cnVlIgogICAgICAgIH0sCiAgICAgICAgImRlZmF1bHRPdXRwdXREZXN0aW5hdGlvbkNvbmZpZ3VyYXRpb24iOiBudWxsLAogICAgICAgICJzdGFnaW5nRGVmaW5pdGlvbiI6IG51bGwKICAgIH0KfQ==",  
        "payloadType": "InlineBase64"  
      } 
    ] 
  } 
}

mallivastauksen

200 OK

Poista tietovuo

Poistaa määritetyn tietovuon.

Mallipyyntö

URI: DELETE [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d)  

Headers: 

{ 
  "Authorization": "\<bearer-token>" 
}

mallivastauksen

200 OK

Suorita pyydettäessä suoritettava tietovuotyö (päivitys)

Suorittaa pyydettäessä suoritettavan tietovuotyön päivitysesiintymän osalta.

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/jobs/instances?jobType=Refresh](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d/jobs/instances?jobType=Refresh)  

Headers: 

{ 
  "Authorization": "\<bearer-token>" 
} 

Payload: 

{ 
    "executionData": { 
        "DataflowName": "Dataflow", 
        "OwnerUserPrincipalName": "\<name@email.com>", 
        "OwnerUserObjectId": "\<ObjectId>" 
    } 
}

mallivastauksen

202 Accepted 
[ 
  { 
    "id": "\<jobId>", 
    "itemId": "\<dataflowItemId>", 
    "jobType": "Refresh", 
    "invokeType": "OnDemand", 
    "status": "Accepted", 
    "jobInstanceId": "\<uniqueJobInstanceId>", 
    "rootActivityId": "\<rootActivityId>", 
    "startTimeUtc": "2025-01-30T11:10:50Z", 
    "endTimeUtc": null, 
    "failureReason": null 
  } 
]

Suorita pyydettäessä suoritettava tietovuon julkaisutyö

Suorittaa pyydettäessä suoritettavan tietovuotyön julkaisuesiintymälle.

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/jobs/instances?jobType=Publish](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d/jobs/instances?jobType=Publish) 

Headers: 

{ 
  "Authorization": "\<bearer-token>" 
} 

Payload: 

{ 
    "executionData": { 
        "DataflowName": "Dataflow", 
        "OwnerUserPrincipalName": "\<name@email.com>", 
        "OwnerUserObjectId": "\<ObjectId>" 
    }
}

mallivastauksen

202 Accepted 

[ 
  { 
    "id": "\<jobId>", 
    "itemId": "\<dataflowItemId>", 
    "jobType": "Publish", 
    "invokeType": "OnDemand", 
    "status": "Accepted", 
    "jobInstanceId": "\<uniqueJobInstanceId>", 
    "rootActivityId": "\<rootActivityId>", 
    "startTimeUtc": "2025-01-30T11:10:50Z", 
    "endTimeUtc": null, 
    "failureReason": null 
  } 
]

Nouda tietovuotyön esiintymä

Hakee tietovuon työesiintymän.

Mallipyyntö

URI: GET [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/jobs/instances/{jobInstanceId}](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d/jobs/instances/%7bjobInstanceId%7d)  

Headers: 

{ 
  "Authorization": "\<bearer-token>" 
}

mallivastauksen

{ 
  "id": "\<id>", 
  "itemId": "<itemId?", 
  "jobType": "Refresh", 
  "invokeType": "Manual", 
  "status": "Completed", 
  "rootActivityId": "\<rootActivityId>", 
  "startTimeUtc": "2023-08-22T06:35:00.7812154", 
  "endTimeUtc": "2023-08-22T06:35:00.8033333", 
  "failureReason": null 
}

Peruuta tietovuotyön esiintymä

Tietovuon työesiintymän peruuttaminen

Mallipyyntö

URI: POST [https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/jobs/instances/{jobInstanceId}/cancel](https://api.fabric.microsoft.com/v1/workspaces/%7bworkspaceId%7d/items/%7bitemId%7d/jobs/instances/%7bjobInstanceId%7d/cancel)  

Headers: 

{ 
  "Authorization": "\<bearer-token>"
}

mallivastauksen

Location: https://api.fabric.microsoft.com/v1/workspaces/\<worksapceId>/items/\<itemId>/jobs/instances/\<jobInstanceId> 

Retry-After: 60

Nykyiset rajoitukset

Palvelun päänimen todentamista ei tueta tällä hetkellä.
"Hae kohde" ja "Luettelokohteen käyttötiedot" eivät palauta oikeita tietoja, jos suodatat tietovuon kohdetyyppiä.
Kun et määritä tyyppiä, se palauttaa Tietovuon Gen2 (CI/CD, esikatselu) - uuden tietovuon Gen2 CI/CD- ja GIT-tuella.
Suorituksen ohjelmointirajapinnat ovat kutsuttavia, mutta todellinen suoritus ei koskaan onnistu.

Jaa

Julkiset ohjelmointirajapinnat tietovoid Gen2:lle Fabric Data Factoryssa

Ohjelmointirajapintojen tietovoiden käyttötapaukset

Ohjelmointirajapintojen ymmärtäminen

CRUD-tuki

Tietovuon elinkaari

Tietovoiden julkisten ohjelmointirajapintojen käytön aloittaminen

Valtuutustunnuksen hankkiminen

MSAL.Net

Fabric-portaali

Luo tietovuo

Luo tietovuo määrityksen avulla

Hae tietovuo

Hae tietovuo määrityksen kanssa

Päivitä tietovuo

Päivitä tietovuo määrityksellä

Poista tietovuo

Suorita pyydettäessä suoritettava tietovuotyö (päivitys)

Suorita pyydettäessä suoritettava tietovuon julkaisutyö

Nouda tietovuotyön esiintymä

Peruuta tietovuotyön esiintymä

Nykyiset rajoitukset

Liittyvä sisältö

Ohjeet

Opetusohjelmat

Palaute

Lisäresursseja