Asynchronní aktualizace s využitím rozhraní REST API

Pomocí libovolného programovacího jazyka, který podporuje volání REST, můžete provádět asynchronní operace aktualizace dat na vašich Azure Analysis Services tabelárních modelech. To zahrnuje synchronizaci replik jen pro čtení pro horizontální navýšení kapacity dotazů.

Operace aktualizace dat můžou určitou dobu trvat v závislosti na řadě faktorů, včetně objemu dat, úrovně optimalizace pomocí oddílů atd. Tyto operace byly tradičně vyvolány s existujícími metodami, jako je například použití modelu (tabelární objektový model), rutin prostředí PowerShell nebo TMSL (skriptovací jazyk tabelárního modelu). Tyto metody ale můžou vyžadovat často nespolehlivá, dlouhodobě běžící připojení HTTP.

REST API pro Azure Analysis Services umožňuje asynchronní provádění operací aktualizace dat. Když použijete REST API, dlouhotrvající připojení HTTP z klientských aplikací není nutné. K dispozici jsou také další integrované funkce pro spolehlivost, například automatické opakování a dávková potvrzení.

Základní adresa URL

Základní adresa URL má následující formát:

https://<rollout>.asazure.windows.net/servers/<serverName>/models/<resource>/

Představte si třeba model nazvaný AdventureWorks na serveru s názvem myserver , který je umístěný v západní USA oblasti Azure. Název serveru:

asazure://westus.asazure.windows.net/myserver 

Základní adresa URL tohoto názvu serveru je:

https://westus.asazure.windows.net/servers/myserver/models/AdventureWorks/ 

Pomocí základní adresy URL lze prostředky a operace připojit na základě následujících parametrů:

• Cokoli, co končí v s , je kolekce.
• Cokoli, co končí () je funkce.
• Cokoli jiného je prostředek nebo objekt.

Můžete například použít příkaz POST v kolekci reaktuálnosti k provedení operace aktualizace:

https://westus.asazure.windows.net/servers/myserver/models/AdventureWorks/refreshes

Authentication

Všechna volání musí být ověřena pomocí platného tokenu Azure Active Directory (OAuth 2) v autorizační hlavičce a musí splňovat následující požadavky:

• Token musí být buď token uživatele, nebo objekt služby aplikace.

• Token musí mít nastavenou správnou cílovou skupinu https://*.asazure.windows.net .

• Aby mohl uživatel nebo aplikace provést požadované volání, musí mít na serveru nebo v modelu dostatečná oprávnění. Úroveň oprávnění je určena rolemi v rámci modelu nebo skupiny pro správu na serveru.

  Důležité

  V současné době jsou nutná oprávnění role Správce serveru .

PŘÍSPĚVEK/refreshes

Chcete-li provést operaci aktualizace, přidejte do kolekce novou položku aktualizace pomocí příkazu POST v kolekci/refreshes. Hlavička umístění v odpovědi zahrnuje ID aktualizace. Klientská aplikace se může v případě potřeby odpojit a později ověřit stav, protože je asynchronní.

V jednom okamžiku se pro model přijme jenom jedna operace aktualizace. Pokud existuje aktuální spuštěná operace aktualizace a je odeslána jiná, vrátí se stavový kód HTTP v konfliktu 409.

Tělo může vypadat takto:

{
    "Type": "Full",
    "CommitMode": "transactional",
    "MaxParallelism": 2,
    "RetryCount": 2,
    "Objects": [
        {
            "table": "DimCustomer",
            "partition": "DimCustomer"
        },
        {
            "table": "DimDate"
        }
    ]
}

Parametry

Určení parametrů není vyžadováno. Použije se výchozí hodnota.

CommitMode se rovná partialBatch. Používá se při počátečním zatížení velkých datových sad, které mohou trvat hodiny. Pokud operace aktualizace selže po úspěšném potvrzení jedné nebo více dávek, všechny úspěšně potvrzené dávky zůstanou popsány (nevrátí úspěšně potvrzené dávky).

Hodnoty stavu

ZÍSKAT/refreshes/<refreshId>

Chcete-li zjistit stav operace aktualizace, použijte příkaz GET v ID aktualizace. Tady je příklad těla odpovědi. Pokud operace probíhá, inProgress vrátí se stav.

{
    "startTime": "2017-12-07T02:06:57.1838734Z",
    "endTime": "2017-12-07T02:07:00.4929675Z",
    "type": "full",
    "status": "succeeded",
    "currentRefreshType": "full",
    "objects": [
        {
            "table": "DimCustomer",
            "partition": "DimCustomer",
            "status": "succeeded"
        },
        {
            "table": "DimDate",
            "partition": "DimDate",
            "status": "succeeded"
        }
    ]
}

ZÍSKAT/refreshes

Chcete-li získat seznam historických operací aktualizace pro model, použijte příkaz GET v kolekci/refreshes. Tady je příklad těla odpovědi.

[
    {
        "refreshId": "1344a272-7893-4afa-a4b3-3fb87222fdac",
        "startTime": "2017-12-07T02:06:57.1838734Z",
        "endTime": "2017-12-07T02:07:00.4929675Z",
        "status": "succeeded"
    },
    {
        "refreshId": "474fc5a0-3d69-4c5d-adb4-8a846fa5580b",
        "startTime": "2017-12-07T01:05:54.157324Z",
        "endTime": "2017-12-07T01:05:57.353371Z",
        "status": "succeeded"
    }
]

Odstranit/refreshes/<refreshId>

Chcete-li zrušit probíhající operaci aktualizace, použijte příkaz DELETE pro ID aktualizace.

PŘÍSPĚVEK/Sync

Po provedení operací aktualizace může být nutné synchronizovat nová data s replikami pro škálování dotazu. K provedení operace synchronizace pro model použijte příkaz POST ve funkci/Sync. Hlavička umístění v odpovědi zahrnuje ID operace synchronizace.

ZÍSKAT stav/Sync

Chcete-li zjistit stav operace synchronizace, použijte příkaz GET s předáním ID operace jako parametru. Tady je příklad těla odpovědi:

{
    "operationId": "cd5e16c6-6d4e-4347-86a0-762bdf5b4875",
    "database": "AdventureWorks2",
    "UpdatedAt": "2017-12-09T02:44:26.18",
    "StartedAt": "2017-12-09T02:44:20.743",
    "syncstate": 2,
    "details": null
}

Hodnoty pro syncstate :

• 0: replikace. Soubory databáze jsou replikovány do cílové složky.
• 1: rehydratované. Probíhá rehydratované databáze na instancích serveru jen pro čtení.
• 2: dokončeno. Operace synchronizace se úspěšně dokončila.
• 3: selhalo. Operace synchronizace se nezdařila.
• 4: dokončuje se. Operace synchronizace se dokončila, ale provádí kroky čištění.

Ukázka kódu

Tady je ukázka kódu C#, která vám umožní začít RestApiSample na GitHubu.

Použití ukázky kódu

1. Naklonujte nebo Stáhněte úložiště. Otevřete řešení RestApiSample.
2. Najděte klienta line . BaseAddress =... a zadejte svou základní adresu URL.

Ukázka kódu používá ověřování instančního objektu .

Instanční objekt

Další informace o tom, jak nastavit instanční objekt a přiřadit potřebná oprávnění v Azure jako, najdete v tématu Vytvoření instančního objektu – Azure Portal a Přidání instančního objektu k roli správce serveru . Po dokončení kroků proveďte následující další kroky:

1. V ukázce kódu vyhledejte řetězcovou autoritu =..., nahraďte Common číslem ID tenanta vaší organizace.
2. Komentář/Odkomentujte, aby se třída ClientCredential použila k vytvoření instance objektu přihlašovacích údajů. Ujistěte se, že <App ID> <App Key> hodnoty a jsou dostupné zabezpečeným způsobem, nebo používejte ověřování pomocí certifikátů u instančních objektů.
3. Spusťte ukázku.

Viz také

Vzory
REST API