Připojení k databázi SQL z pracovních postupů v Azure Logic Apps

Platí pro: Azure Logic Apps (Consumption + Standard)

Tento článek ukazuje, jak získat přístup k databázi SQL z pracovního postupu v Azure Logic Apps pomocí konektoru SQL Server. Pak můžete vytvořit automatizované pracovní postupy, které se spouštějí při aktivaci událostmi ve vaší databázi SQL nebo v jiných systémech a spouštět akce pro správu dat a prostředků SQL.

Pracovní postup může například spouštět akce, které získávají, vkládají a odstraňují data nebo můžou spouštět dotazy SQL a uložené procedury. Pracovní postup může zkontrolovat nové záznamy v databázi, která není SQL, provést určité zpracování, použít výsledky k vytvoření nových záznamů v databázi SQL a odesílat e-mailové výstrahy o nových záznamech.

Pokud s Azure Logic Apps začínáte, projděte si následující úvodní dokumentaci:

Podporované edice SQL

Konektor SQL Server podporuje následující edice SQL:

Technické reference ke konektoru

Konektor SQL Server má různé verze založené na typu aplikace logiky a hostitelském prostředí.

Aplikace logiky Prostředí Verze konektoru
Využití Azure Logic Apps s více tenanty Spravovaný konektor (třída Standard) Další informace najdete v následující dokumentaci:

- referenční informace ke spravovanému konektoru SQL Server
- Spravované konektory v Azure Logic Apps
Využití Prostředí integrační služby (ISE) Spravovaný konektor (třída Standard) a verze ISE, která má různá omezení zpráv než třída Standard. Další informace najdete v následující dokumentaci:

- referenční informace ke spravovanému konektoru SQL Server
- Omezení zpráv ISE
- Spravované konektory v Azure Logic Apps
Standard Azure Logic Apps s jedním tenantem a App Service Environment v3 (jenom plány Windows) Spravovaný konektor (hostovaný v Azure) a integrovaný konektor, který je založený na poskytovateli služeb. Předdefinovaná verze se liší následujícími způsoby:

– Integrovaná verze nemá triggery. Můžete použít trigger spravovaného konektoru SQL nebo jiný trigger.

– Integrovaná verze se může připojit přímo k databázi SQL a přistupovat k virtuálním sítím Azure. Nepotřebujete místní bránu dat.

Další informace najdete v následující dokumentaci:

- referenční informace ke spravovanému konektoru SQL Server
- SQL Server předdefinované referenční části konektoru dále v tomto článku
- Integrované konektory v Azure Logic Apps

Omezení

Další informace najdete v referenčních informacích ke spravovanému konektoru SQL Server nebo SQL Server předdefinovaných referenčních informací ke konektoru.

Požadavky

  • Účet a předplatné Azure. Pokud předplatné nemáte, zaregistrujte si bezplatný účet Azure.

  • SQL Server databáze, databáze Azure SQL nebo SQL Managed Instance.

    Konektor SQL Server vyžaduje, aby vaše tabulky obsahovaly data, aby operace konektoru mohly při volání vracet výsledky. Pokud například používáte Azure SQL Database, můžete použít zahrnuté ukázkové databáze k vyzkoušení operací SQL Server konektoru.

  • Informace potřebné k vytvoření připojení k databázi SQL, jako je váš sql server a název databáze. Pokud k ověřování přístupu používáte ověřování systému Windows nebo ověřování SQL Server, potřebujete také svoje uživatelské jméno a heslo. Tyto informace obvykle najdete v připojovacím řetězci.

    Důležité

    Pokud používáte připojovací řetězec SQL Server, který jste zkopírovali přímo z Azure Portal, musíte do připojovacího řetězce ručně přidat heslo.

    • Pro databázi SQL v Azure má připojovací řetězec následující formát:

      Server=tcp:{your-server-name}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

      1. Pokud chcete tento řetězec najít v Azure Portal, otevřete databázi.

      2. V nabídce databáze v části Vlastnosti vyberte Připojovací řetězce.

    • Pro místní SQL server má připojovací řetězec následující formát:

      Server={your-server-address};Database={your-database-name};User Id={your-user-name};Password={your-password};

  • Pracovní postup aplikace logiky, ve kterém chcete získat přístup k databázi SQL. Pokud chcete pracovní postup spustit pomocí triggeru SQL Server, musíte začít s prázdným pracovním postupem. Pokud chcete použít akci SQL Server, spusťte pracovní postup s libovolným triggerem.

  • Pokud se chcete připojit k místnímu SQL serveru, platí následující dodatečné požadavky na základě toho, jestli máte pracovní postup aplikace logiky Consumption nebo Standard.

    • Pracovní postup aplikace logiky Consumption

    • Standardní pracovní postup aplikace logiky

      Můžete použít SQL Server integrovaný konektor nebo spravovaný konektor.

      • Pokud chcete použít integrovaný konektor, můžete připojení ověřit pomocí spravované identity, active directory OAuth nebo připojovacího řetězce. Sdružování připojení můžete upravit zadáním parametrů v připojovacím řetězci. Další informace najdete v tématu Sdružování připojení.

      • Pokud chcete používat SQL Server spravovaný konektor, postupujte podle stejných požadavků jako pracovní postup aplikace logiky Consumption ve službě Azure Logic Apps s více tenanty. Další požadavky na konektor najdete v referenčních informacích ke spravovanému konektoru SQL Server.

Přidání triggeru SQL Server

Následující kroky používají Azure Portal, ale s příslušným rozšířením Azure Logic Apps můžete také vytvořit pracovní postupy aplikací logiky pomocí následujících nástrojů:

  1. V Azure Portal otevřete v návrháři prázdný pracovní postup aplikace logiky.

  2. Vyhledejte a vyberte aktivační událost SQL Server, kterou chcete použít.

    1. V návrháři pod vyhledávacím polem vyberte Standardní.

    2. Do vyhledávacího pole zadejte sql server.

    3. V seznamu triggerů vyberte požadovanou aktivační událost SQL.

      Tento příklad pokračuje triggerem s názvem Při vytvoření položky.

      Snímek obrazovky znázorňující Azure Portal, návrháře pracovních postupů aplikace logiky Consumption, vyhledávací pole s vybranou aktivační událostí SQL Server a Při vytvoření položky

  3. Zadejte informace o připojení. Po dokončení vyberte Vytvořit.

  4. Po zobrazení informačního pole triggeru zadejte interval a frekvenci, jak často aktivační událost kontroluje tabulku.

  5. Pokud chcete přidat další vlastnosti dostupné pro tento trigger, otevřete seznam Přidat nový parametr a vyberte tyto vlastnosti.

    Tento trigger vrátí pouze jeden řádek z vybrané tabulky a nic jiného. Pokud chcete provádět další úlohy, pokračujte přidáním akce konektoru SQL Server nebo jinou akcí, která provede další úlohu, kterou chcete provést v pracovním postupu aplikace logiky.

    Pokud chcete například zobrazit data v tomto řádku, můžete přidat další akce, které vytvoří soubor, který obsahuje pole z vráceného řádku, a poté odeslat e-mailová upozornění. Další informace o dalších dostupných akcích pro tento konektor najdete v referenčních informacích ke spravovanému konektoru SQL Server.

  6. Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Když pracovní postup uložíte, tento krok automaticky publikuje vaše aktualizace do nasazené aplikace logiky, která je živá v Azure. S pouze triggerem váš pracovní postup kontroluje databázi SQL na základě zadaného plánu. Musíte přidat akci , která reaguje na trigger.

Aktivace posunu opakování a posunu (letní čas)

Opakované triggery založené na připojení, kde potřebujete nejprve vytvořit připojení, například trigger SQL Server spravovaného konektoru, se liší od předdefinovaných triggerů, které běží nativně v Azure Logic Apps, jako je trigger opakování. U aktivačních událostí založených na opakovaném připojení není plán opakování jediným ovladačem, který řídí provádění, a časové pásmo určuje pouze počáteční čas spuštění. Následné spuštění závisí na plánu opakování, posledním spuštění triggeru a dalších faktorech, které můžou způsobit posun doby spuštění nebo neočekávané chování. Neočekávané chování může například zahrnovat selhání údržby zadaného plánu při zahájení a ukončení letního času (DST).

Pokud chcete zajistit, aby se doba opakování při efektu DST nepřesoula, upravte opakování ručně. Pracovní postup se tak bude dál spouštět v očekávaném nebo zadaném čase zahájení. V opačném případě se počáteční čas posune o hodinu dopředu při spuštění DST a jednu hodinu zpět při ukončení DST. Další informace najdete v tématu Opakování aktivačních událostí založených na připojení.

Přidání akce SQL Server

Následující kroky používají Azure Portal, ale s příslušným rozšířením Azure Logic Apps můžete také pomocí sady Visual Studio upravit pracovní postupy aplikací logiky Consumption nebo Visual Studio Code na následující nástroje k úpravě pracovních postupů aplikace logiky:

V tomto příkladu pracovní postup aplikace logiky začíná triggerem Opakování a volá akci, která získá řádek z databáze SQL.

  1. V Azure Portal otevřete pracovní postup aplikace logiky v návrháři.

  2. Vyhledejte a vyberte akci SQL Server, kterou chcete použít.

    Tento příklad pokračuje akcí s názvem Získat řádek.

    1. Pod triggerem nebo akcí, do které chcete přidat akci SQL, vyberte Nový krok.

      Nebo pokud chcete přidat akci mezi existující kroky, přesuňte ukazatel myši na spojovací šipku. Vyberte znaménko plus (+), které se zobrazí, a pak vyberte Přidat akci.

    2. Pod vyhledávacím polem Zvolit operaci vyberte Standardní.

    3. Do vyhledávacího pole zadejte sql server.

    4. V seznamu akcí vyberte požadovanou akci SQL Server.

      Tento příklad používá akci Získat řádek , která získá jeden záznam.

      Snímek obrazovky znázorňující aplikaci logiky Azure Portal, návrháře pracovního postupu pro aplikaci logiky Consumption, vyhledávací pole s sql serverem a vybranou možnost Získat řádek v seznamu Akce

  3. Zadejte informace o připojení. Po dokončení vyberte Vytvořit.

  4. Pokud jste ještě nezadali název serveru SQL a název databáze, zadejte tyto hodnoty. V opačném případě ze seznamu názvů tabulek vyberte tabulku, kterou chcete použít. Do vlastnosti ID řádku zadejte ID požadovaného záznamu.

    V tomto příkladu je název tabulky SalesLT.Customer.

    Snímek obrazovky zobrazující návrháře pracovního postupu Consumption a akci Získat řádek s ukázkou hodnoty vlastnosti Název tabulky a ID prázdného řádku

    Tato akce vrátí pouze jeden řádek z vybrané tabulky a nic jiného. Pokud chcete zobrazit data v tomto řádku, přidejte další akce. Například takové akce můžou vytvořit soubor, zahrnout pole z vráceného řádku a uložit soubor do účtu cloudového úložiště. Další dostupné akce pro tento konektor najdete na referenční stránce konektoru.

  5. Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Připojení k databázi

Když přidáte trigger nebo akci, která se připojí ke službě nebo systému a nemáte existující nebo aktivní připojení, Azure Logic Apps vás vyzve k zadání informací o připojení, které se liší podle typu připojení, například:

  • Přihlašovací údaje k vašemu účtu
  • Název, který se má použít pro připojení
  • Název serveru nebo systému
  • Typ ověřování, který se má použít
  • Připojovací řetězec

Po zadání těchto informací pokračujte následujícími kroky na základě cílové databáze:

Připojení k databázi Azure SQL nebo SQL Managed Instance

Pokud chcete získat přístup k SQL Managed Instance bez použití místní brány dat nebo prostředí integrační služby, musíte na SQL Managed Instance nastavit veřejný koncový bod. Veřejný koncový bod používá port 3342, proto při vytváření připojení z aplikace logiky nezapomeňte zadat toto číslo portu.

V okně s informacemi o připojení proveďte následující kroky:

  1. Jako název připojení zadejte název, který se má použít pro vaše připojení.

  2. Jako typ ověřování vyberte ověřování, které je požadováno a povoleno ve vaší databázi v Azure SQL Databáze nebo SQL Managed Instance:

    Authentication Description
    Připojovací řetězec – Podporuje se pouze ve standardních pracovních postupech s integrovaným konektorem SQL Server.

    – Vyžaduje připojovací řetězec k sql serveru a databázi.
    Spravovaná identita služby Logic Apps – Podporuje se u SQL Server spravovaného konektoru a konektoru isE verze. Ve standardních pracovních postupech je tento typ ověřování dostupný pro integrovaný konektor SQL Server, ale tato možnost se jmenuje Spravovaná identita.

    – Vyžaduje následující položky:

    --- platnou spravovanou identitu, která je povolená u prostředku aplikace logiky a má přístup k vaší databázi.

    --- Přístup role Přispěvatel databáze SQL k prostředku SQL Server

    --- Přístup přispěvatele ke skupině prostředků, která zahrnuje prostředek SQL Server.

    Další informace najdete v následující dokumentaci:

    - Ověřování spravované identity pro konektor SQL Server
    - SQL – role Server-Level
    Active Directory OAuth – Podporuje se pouze ve standardních pracovních postupech s integrovaným konektorem SQL Server. Další informace najdete v následující dokumentaci:

    - Ověřování pro konektor SQL Server
    - Povolení otevřeného ověřování Azure Active Directory (Azure AD OAuth)
    - Otevřené ověřování Azure Active Directory
    Instanční objekt (aplikace Azure AD) – Podporováno pomocí SQL Server spravovaného konektoru.

    – Vyžaduje Azure AD aplikaci a instanční objekt. Další informace najdete v tématu Vytvoření aplikace Azure AD a instančního objektu, který má přístup k prostředkům pomocí Azure Portal.
    integrované Azure AD – Podporuje se u SQL Server spravovaného konektoru a konektoru isE verze.

    – Vyžaduje platnou spravovanou identitu ve službě Azure Active Directory (Azure AD), která je povolená pro prostředek aplikace logiky a má přístup k vaší databázi. Další informace najdete v těchto tématech:

    - přehled zabezpečení Azure SQL – ověřování
    - Autorizace přístupu k databázi k Azure SQL – ověřování a autorizace
    - Azure SQL – integrované ověřování Azure AD
    ověřování SQL Server – Podporuje se u SQL Server spravovaného konektoru a konektoru isE verze.

    – Vyžaduje následující položky:

    --- prostředek brány dat, který byl dříve vytvořený v Azure pro vaše připojení, bez ohledu na to, jestli je vaše aplikace logiky ve více tenantech Azure Logic Apps nebo ISE.

    --- platné uživatelské jméno a silné heslo, které se vytvoří a uloží do databáze SQL Server. Další informace najdete v následujících tématech:

    - přehled zabezpečení Azure SQL – ověřování
    - Autorizace přístupu k databázi k Azure SQL – ověřování a autorizace

    Následující příklady ukazují, jak se může zobrazit informační okno připojení, pokud používáte SQL Server spravovaný konektor a vyberete Azure AD integrované ověřování:

    • Pracovní postupy aplikací logiky Consumption

      Snímek obrazovky znázorňující informace o cloudovém připojení Azure Portal, návrháře pracovního postupu a

    • Standardní pracovní postupy aplikací logiky

      Snímek obrazovky znázorňující informace o Azure Portal, návrháři pracovních postupů a

  3. Po výběru Azure AD Integrované vyberte Přihlásit se. Na základě toho, jestli používáte Azure SQL Database nebo SQL Managed Instance, vyberte přihlašovací údaje uživatele k ověřování.

  4. Vyberte tyto hodnoty pro vaši databázi:

    Vlastnost Povinné Popis
    Název serveru Yes Adresa vašeho SQL serveru, například Fabrikam-Azure-SQL.database.windows.net
    Název databáze Yes Název databáze SQL, například Fabrikam-Azure-SQL-DB
    Název tabulky Yes Tabulka, kterou chcete použít, například SalesLT.Customer

    Tip

    Pokud chcete poskytnout informace o databázi a tabulce, máte tyto možnosti:

    • Najděte tyto informace v připojovacím řetězci databáze. Například v Azure Portal vyhledejte a otevřete databázi. V nabídce databáze vyberte připojovací řetězce nebo vlastnosti, kde najdete následující řetězec:

      Server=tcp:{your-server-address}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

    • Ve výchozím nastavení se tabulky v systémových databázích vyfiltrují, takže se při výběru systémové databáze nemusí automaticky zobrazovat. Jako alternativu můžete název tabulky zadat ručně po výběru možnosti Zadat vlastní hodnotu ze seznamu databáze.

    Toto pole s informacemi o databázi vypadá podobně jako v následujícím příkladu:

    • Pracovní postupy aplikací logiky Consumption

      Snímek obrazovky znázorňující informace o cloudu cloudové databáze SQL s ukázkovými hodnotami pro Consumption

    • Standardní pracovní postupy aplikací logiky

      Snímek obrazovky zobrazující informace o cloudové databázi SQL s ukázkovými hodnotami pro Standard

  5. Teď pokračujte kroky, které jste ještě nedokončili, buď přidáním triggeru SQL , nebo přidáním akce SQL.

Připojení k místnímu SQL Server

V okně s informacemi o připojení proveďte následující kroky:

  1. Pokud chcete připojení k místnímu SQL serveru, který vyžaduje místní bránu dat, ujistěte se, že jste dokončili tyto požadavky.

    V opačném případě se prostředek brány dat nezobrazí v seznamu brány připojení při vytváření připojení.

  2. U typu ověřování vyberte požadované a povolené ověřování ve vašem SQL Server:

    Authentication Description
    ověřování SQL Server – Podporováno pomocí SQL Server spravovaného konektoru, SQL Server integrovaného konektoru a konektoru isE ve verzi.

    – Vyžaduje následující položky:

    --- prostředek brány dat, který byl dříve vytvořený v Azure pro vaše připojení, bez ohledu na to, jestli je vaše aplikace logiky ve více tenantech Azure Logic Apps nebo ISE.

    --- platné uživatelské jméno a silné heslo, které se vytvoří a uloží ve vašem SQL Server.

    Další informace najdete v tématu SQL Server Ověřování.
    Ověřování systému Windows – Podporováno se spravovaným konektorem SQL Server.

    – Vyžaduje následující položky:

    --- prostředek brány dat vytvořený dříve v Azure pro vaše připojení bez ohledu na to, jestli je vaše aplikace logiky ve víceklientské službě Azure Logic Apps nebo isE.

    --- platné uživatelské jméno a heslo systému Windows k potvrzení vaší identity prostřednictvím účtu Windows.

    Další informace najdete v tématu Integrované ověřování Windows.
  3. Vyberte nebo zadejte následující hodnoty pro vaši databázi SQL:

    Vlastnost Povinné Popis
    Název serveru SQL Yes Adresa vašeho SQL serveru, například Fabrikam-Azure-SQL.database.windows.net
    Název databáze SQL Yes Název databáze SQL Server, napříkladFabrikam-Azure-SQL-DB
    Uživatelské jméno Yes Vaše uživatelské jméno pro SQL server a databázi
    Heslo Yes Heslo pro SQL Server a databázi
    Předplatné Ano, pro ověřování systému Windows Předplatné Azure pro prostředek brány dat, který jste předtím vytvořili v Azure
    Brána připojení Ano, pro ověřování systému Windows Název prostředku brány dat, který jste dříve vytvořili v Azure



    Tip: Pokud se brána v seznamu nezobrazí, zkontrolujte, jestli jste bránu správně nastavili.

    Tip

    Tyto informace najdete v připojovacím řetězci databáze:

    • Server={your-server-address}
    • Database={your-database-name}
    • User ID={your-user-name}
    • Password={your-password}

    Následující příklady ukazují, jak se může zobrazit okno s informacemi o připojení, pokud vyberete ověřování systému Windows .

    • Pracovní postupy aplikace logiky Consumption

      Snímek obrazovky znázorňující informace o místním připojení Azure Portal, návrháři pracovních postupů a informací o místním připojení SQL Server s vybraným ověřováním pro Consumption

    • Standardní pracovní postupy aplikace logiky

      Snímek obrazovky znázorňující informace o místním připojení Azure Portal, návrháře pracovního postupu a informace o místním připojení SQL Server s vybraným ověřováním pro Standard

  4. Až budete připraveni, vyberte Vytvořit.

  5. Teď pokračujte kroky, které jste ještě nedokončili, buď přidáním triggeru SQL , nebo přidáním akce SQL.

Zpracování hromadných dat

Někdy pracujete se sadami výsledků tak velkou, že konektor nevrací všechny výsledky najednou. Nebo chcete mít lepší kontrolu nad velikostí a strukturou sad výsledků. Následující seznam obsahuje některé způsoby, jak tyto velké sady výsledků zpracovat:

Zpracování dynamických hromadných dat

Při volání uložené procedury pomocí konektoru SQL Server je vrácený výstup někdy dynamický. V tomto scénáři postupujte takto:

  1. V Azure Portal otevřete pracovní postup aplikace logiky v návrháři.

  2. Zobrazte výstupní formát provedením testovacího spuštění. Zkopírujte a uložte ukázkový výstup.

  3. V návrháři v rámci akce, ve které voláte uloženou proceduru, přidejte novou akci.

  4. V poli Zvolit operaci vyhledejte a vyberte akci s názvem Parsovat JSON.

  5. V akci Parsovat JSON vyberte k vygenerování schématu možnost Použít ukázkovou datovou část.

  6. Do pole Enter nebo vložení ukázkové datové části JSON vložte ukázkový výstup a vyberte Hotovo.

    Poznámka

    Pokud se zobrazí chyba, že Azure Logic Apps nemůže vygenerovat schéma, zkontrolujte, jestli je syntaxe ukázkového výstupu správně naformátovaná. Pokud schéma pořád nemůžete vygenerovat, zadejte schéma ručně do pole Schéma .

  7. Až budete hotovi, uložte pracovní postup.

  8. Pokud chcete odkazovat na vlastnosti obsahu JSON, klikněte do polí pro úpravy, na které chcete odkazovat na tyto vlastnosti, aby se zobrazil seznam dynamického obsahu. V seznamu v části Parsovat JSON vyberte datové tokeny pro požadované vlastnosti obsahu JSON.

Integrovaná nastavení aplikace konektoru

V prostředku aplikace logiky standardu obsahuje integrovaný konektor SQL Server nastavení aplikace, která řídí různé prahové hodnoty výkonu, propustnosti, kapacity atd. Můžete například změnit hodnotu časového limitu dotazu z 30 sekund. Další informace najdete v referenčních informacích k nastavení aplikace – local.settings.json.

Integrované operace konektoru SQL

Integrovaný konektor SQL Server je k dispozici pouze pro pracovní postupy standardní aplikace logiky a poskytuje následující akce, ale žádné triggery:

Akce Popis
Odstranění řádků Odstraní a vrátí řádky tabulky, které odpovídají zadané hodnotě podmínky Where .
Spustit dotaz Spustí dotaz na databázi SQL.
Spustit uloženou proceduru Spustí uloženou proceduru v databázi SQL.
Získání řádků Získá řádky tabulky, které odpovídají zadané hodnotě podmínky Where .
Získání tabulek Získá všechny tabulky z databáze.
Vložení řádku Vloží do zadané tabulky jeden řádek.
Aktualizace řádků Aktualizace zadaných sloupců ve všech řádcích tabulky, které odpovídají zadané hodnotě podmínky Where, pomocí názvů a hodnot sloupce Nastavit sloupce.

Odstranění řádků

ID operace: deleteRows

Odstraní a vrátí řádky tabulky, které odpovídají zadané hodnotě podmínky Where .

Parametry

Name Klíč Požaduje se Typ Description
Název tabulky tableName Ano Řetězec Název tabulky
Kde podmínka columnValuesForWhereCondition Ano Objekt Tento objekt obsahuje názvy sloupců a odpovídající hodnoty použité k výběru řádků, které chcete odstranit. Pokud chcete tyto informace poskytnout, postupujte podle formátu páru klíč-hodnota , například columnName a columnValue, který vám také umožňuje zadat jeden nebo konkrétní řádky, které chcete odstranit.

Návraty

Název Typ
Výsledek Maticový objekt, který vrátí všechny odstraněné řádky. Každý řádek obsahuje název sloupce a odpovídající odstraněnou hodnotu.
Položka výsledku Maticový objekt, který vrací jeden odstraněný řádek najednou. Do pracovního postupu se automaticky přidá smyčka For for each loop to iterate through the array. Každý řádek obsahuje název sloupce a odpovídající odstraněnou hodnotu.

Příklad

Následující příklad ukazuje ukázkové hodnoty parametrů pro akci Odstranit řádky :

Ukázkové hodnoty

Parametr Název JSON Ukázková hodnota
Název tabulky tableName tableName1
Kde podmínka columnValuesForWhereCondition Páry klíč-hodnota:

- <columnName1>, <columnValue1>

- <columnName2>, <columnValue2>

Parametry v základní definici JSON akce

"parameters": {
   "tableName": "tableName1",
   "columnValuesForWhereCondition": {
      "columnName1": "columnValue1",
      "columnName2": "columnValue2"
   }
},

Spustit dotaz

ID operace: executeQuery

Spustí dotaz na databázi SQL.

Parametry

Name Klíč Požaduje se Typ Description
Dotaz query Ano Dynamická Text dotazu SQL
Parametry dotazů queryParameters Ne Objekty Parametry dotazu.

Poznámka: Pokud dotaz vyžaduje vstupní parametry, musíte zadat tyto parametry.

Návraty

Název Typ
Výsledek Maticový objekt, který vrátí všechny výsledky dotazu. Každý řádek obsahuje název sloupce a odpovídající hodnotu.
Položka výsledku Maticový objekt, který vrací jeden výsledek dotazu najednou. Do pracovního postupu se automaticky přidá smyčka For for each loop to iterate through the array. Každý řádek obsahuje název sloupce a odpovídající hodnotu.

Spustit uloženou proceduru

ID operace: executeStoredProcedure

Spustí uloženou proceduru v databázi SQL.

Parametry

Name Klíč Požaduje se Typ Description
Název procedury storedProcedureName Ano Řetězec Název uložené procedury
Parametry storedProcedureParameters Ne Dynamická Parametry uložené procedury.

Poznámka: Pokud uložená procedura vyžaduje vstupní parametry, musíte zadat tyto parametry.

Návraty

Název Typ
Výsledek Objekt obsahující pole sad výsledků, návratový kód a výstupní parametry
Sady výsledků výsledků Pole objektů, které obsahuje všechny sady výsledků z uložené procedury, která může vrátit nula, jednu nebo více sad výsledků.
Návratový kód výsledku Celé číslo, které představuje stavový kód z uložené procedury
Parametry uložené procedury výsledku Objekt obsahující konečné hodnoty výstupních a vstupních parametrů uložené procedury
Stavový kód Stavový kód z operace Provést uloženou proceduru

Získání řádků

ID operace: getRows

Získá řádky tabulky, které odpovídají zadané hodnotě podmínky Where .

Parametry

Name Klíč Požaduje se Typ Description
Název tabulky tableName Ano Řetězec Název tabulky
Kde podmínka columnValuesForWhereCondition Ne Dynamická Tento objekt obsahuje názvy sloupců a odpovídající hodnoty použité k výběru řádků, které chcete získat. Chcete-li poskytnout tyto informace, postupujte podle formátu páru klíč-hodnota , například columnName a columnValue, který vám také umožňuje zadat jeden nebo konkrétní řádky, které chcete získat.

Návraty

Název Typ
Výsledek Maticový objekt, který vrátí všechny výsledky řádku.
Položka výsledku Maticový objekt, který vrací jeden výsledek řádku najednou. Do pracovního postupu se automaticky přidá smyčka For for each loop to iterate through the array.

Příklad

Následující příklad ukazuje ukázkové hodnoty parametrů akce Získat řádky :

Ukázkové hodnoty

Parametr Název JSON Ukázková hodnota
Název tabulky tableName tableName1
Kde podmínka columnValuesForWhereCondition Páry klíč-hodnota:

- <columnName1>, <columnValue1>

- <columnName2>, <columnValue2>

Parametry v základní definici JSON akce

"parameters": {
   "tableName": "tableName1",
   "columnValuesForWhereCondition": {
      "columnName1": "columnValue1",
      "columnName2": "columnValue2"
   }
},

Získání tabulek

ID operace: getTables

Získá seznam všech tabulek v databázi.

Parametry

Žádné

Návraty

Název Typ
Výsledek Maticový objekt, který obsahuje celé názvy a zobrazované názvy pro všechny tabulky v databázi.
Zobrazovaný název výsledku Maticový objekt, který obsahuje zobrazovaný název pro každou tabulku v databázi. Do pracovního postupu se automaticky přidá smyčka For for each loop to iterate through the array.
Celé jméno výsledku Maticový objekt, který obsahuje úplný název každé tabulky v databázi. Do pracovního postupu se automaticky přidá smyčka For for each loop to iterate through the array.
Položka výsledku Maticový objekt, který vrací celý název a zobrazovaný název vždy pro každou tabulku. Do pracovního postupu se automaticky přidá smyčka For for each loop to iterate through the array.

Vložení řádku

ID operace: insertRow

Vloží do zadané tabulky jeden řádek.

Name Klíč Požaduje se Typ Description
Název tabulky tableName Ano Řetězec Název tabulky
Nastavení sloupců setColumns Ne Dynamická Tento objekt obsahuje názvy sloupců a odpovídající hodnoty pro vložení. Pokud chcete tyto informace zadat, postupujte podle formátu páru klíč-hodnota , například columnName a columnValue. Pokud tabulka obsahuje sloupce s výchozími nebo automaticky vygenerovanými hodnotami, můžete toto pole ponechat prázdné.

Návraty

Název Typ
Výsledek Vložený řádek, včetně názvů a hodnot všech automaticky vygenerovaných, výchozích a nulových sloupců hodnot.

Aktualizace řádků

ID operace: updateRows

Aktualizace zadaných sloupců ve všech řádcích tabulky, které odpovídají zadané hodnotě podmínky Where, pomocí názvů a hodnot sloupce Nastavit sloupce.

Name Klíč Požaduje se Typ Description
Název tabulky tableName Ano Řetězec Název tabulky
Kde podmínka columnValuesForWhereCondition Ano Dynamická Tento objekt obsahuje názvy sloupců a odpovídající hodnoty pro výběr řádků, které chcete aktualizovat. Pokud chcete tyto informace poskytnout, postupujte podle formátu páru klíč-hodnota , například columnName a columnValue, který vám také umožňuje zadat jednotlivé nebo konkrétní řádky, které se mají aktualizovat.
Nastavení sloupců setColumns Ano Dynamická Tento objekt obsahuje názvy sloupců a odpovídající hodnoty, které se mají použít pro aktualizaci. Pokud chcete tyto informace zadat, postupujte podle formátu páru klíč-hodnota , například columnName a columnValue.

Návraty

Název Typ
Výsledek Maticový objekt, který vrátí všechny sloupce pro aktualizované řádky.
Výsledná položka Maticový objekt, který vrací jeden sloupec najednou z aktualizovaných řádků. Pro každou smyčku se automaticky přidá do pracovního postupu, který iteruje polem.

Příklad

Následující příklad ukazuje ukázkové hodnoty parametrů pro akci Aktualizovat řádky :

Ukázkové hodnoty

Parametr Název JSON Ukázková hodnota
Název tabulky tableName tableName1
Kde podmínka columnValuesForWhereCondition Páry klíč-hodnota:

- <columnName1>, <columnValue1>

- <columnName2>, <columnValue2>

Parametry v základní definici JSON akce

"parameters": {
   "tableName": "tableName1",
   "columnValuesForWhereCondition": {
      "columnName1": "columnValue1",
      "columnName2": "columnValue2"
   }
},

Poradce při potížích

Problémy s připojením

Problémy s připojením se můžou běžně vyskytnout, takže při řešení potíží a řešení těchto typů problémů si projděte chyby připojení k SQL Server. Následující seznam obsahuje několik příkladů:

  • Při navazování připojení k SQL Serveru došlo k chybě související se sítí nebo konkrétní instancí. Server se nenašel nebo nebyl dostupný. Ověřte správnost názvu instance. Dále ověřte, jestli je SQL Server nakonfigurovaný tak, aby povoloval vzdálená připojení

  • (poskytovatel: Poskytovatel pojmenovaných kanálů, chyba: 40 – Nepodařilo se otevřít připojení k SQL Server) (Microsoft SQL Server, chyba: 53)

  • (zprostředkovatel: Zprostředkovatel TCP, chyba: 0 – Není známý žádný takový hostitel.) (Microsoft SQL Server, chyba: 11001)

Další kroky