Transformace příkazů OLE DB

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Transformace příkazu OLE DB spouští příkaz SQL pro každý řádek v toku dat. Můžete například spustit příkaz SQL, který vloží, aktualizuje nebo odstraní řádky v tabulce databáze.

Transformaci příkazů OLE DB můžete nakonfigurovat následujícími způsoby:

• Zadejte příkaz SQL, který transformace spouští pro každý řádek.

• Zadejte počet sekund před časovým limitem příkazu SQL.

• Zadejte výchozí kódovou stránku.

Příkaz SQL obvykle obsahuje parametry. Hodnoty parametrů jsou uloženy v externích sloupcích ve vstupu transformace a mapování vstupního sloupce na externí sloupec mapuje vstupní sloupec na parametr. Pokud například chcete vyhledat řádky v tabulce DimProduct podle hodnoty ve sloupci ProductKey a pak je odstranit, můžete externí sloupec s názvem Param_0 namapovat na vstupní sloupec s názvem ProductKey a pak spustit příkaz DELETE FROM DimProduct WHERE ProductKey = ?SQL .. Transformace příkazu OLE DB poskytuje názvy parametrů a nemůžete je upravit. Názvy parametrů jsou Param_0, Param_1 atd.

Pokud nakonfigurujete transformaci příkazů OLE DB pomocí dialogového okna Rozšířený editor , parametry v příkazu SQL mohou být mapovány automaticky na externí sloupce ve vstupu transformace a vlastnosti každého parametru definovaného kliknutím na tlačítko Aktualizovat . Pokud však zprostředkovatel OLE DB, který transformace OLE DB používá, nepodporuje odvození informací o parametru z parametru, je nutné nakonfigurovat externí sloupce ručně. To znamená, že musíte přidat sloupec pro každý parametr do externího vstupu transformace, aktualizovat názvy sloupců tak, aby používaly názvy jako Param_0, zadat hodnotu DBParamInfoFlags vlastnost a mapovat vstupní sloupce, které obsahují hodnoty parametrů na externí sloupce.

Hodnota DBParamInfoFlags představuje charakteristiky parametru. Například hodnota 1 určuje, že parametr je vstupní parametr a hodnota 65 určuje, že parametr je vstupní parametr a může obsahovat hodnotu null. Hodnoty musí odpovídat hodnotám v výčtu OLE DBPARAMFLAGSENUM. Další informace naleznete v referenční dokumentaci k OLE DB.

Transformace příkazu OLE DB zahrnuje vlastní vlastnost SQLCommand . Tuto vlastnost lze aktualizovat výrazem vlastnosti při načtení balíčku. Další informace naleznete v tématu Výrazy služby SSIS (Integration Services),použití výrazů vlastností v balíčcích a transformace vlastních vlastností.

Tato transformace má jeden vstup, jeden běžný výstup a jeden chybový výstup.

Logování

Můžete protokolovat volání, která transformace příkazu OLE DB provádí pro externí zprostředkovatele dat. Tuto funkci protokolování můžete použít k řešení potíží s připojeními a příkazy k externím zdrojům dat, které provádí transformace příkazů OLE DB. Chcete-li protokolovat volání, která transformace příkazu OLE DB provádí pro externí zprostředkovatele dat, povolte protokolování balíčku a vyberte diagnostickou událost na úrovni balíčku. Další informace naleznete v tématu Nástroje pro řešení potíží pro spuštění balíčku.

Související úkoly

Transformaci můžete nakonfigurovat pomocí návrháře SSIS nebo objektového modelu. Podrobnosti o programové konfiguraci této transformace najdete v Příručce pro vývojáře.

Konfigurace transformace příkazů OLE DB

Chcete-li přidat a nakonfigurovat transformaci příkazů OLE DB, musí balíček již obsahovat alespoň jednu úlohu toku dat a zdroj, například plochý zdroj souborů nebo zdroj OLE DB. Tato transformace se obvykle používá pro spouštění parametrizovaných dotazů.

Chcete-li konfigurovat transformaci příkazu OLE DB

1. V nástrojích SQL Server Data Tools (SSDT) otevřete projekt Integrační služby, který obsahuje požadovaný balíček.

2. V Průzkumníku řešení poklikáním otevřete balíček.

3. Klikněte na kartu Tok dat a potom na panelu nástrojů přetáhněte transformaci příkazu OLE DB na návrhovou plochu.

4. K připojení transformace příkazu OLE DB ke toku dat použijte konektor - přetáhněte zelenou nebo červenou šipku ze zdroje dat nebo z předchozí transformace k transformaci příkazu OLE DB.

5. Klikněte pravým tlačítkem myši na komponentu a vyberte Upravit nebo Zobrazit rozšířený editor.

6. Na kartě Správci připojení vyberte správce připojení OLE DB v seznamu Správce připojení . Další informace naleznete v tématu OLE DB Connection Manager.

7. Klikněte na kartu Vlastnosti komponenty a v poli SqlCommand klikněte na tlačítko se třemi tečkou (...).

8. V Editoru řetězcových hodnot zadejte parametrizovaný příkaz SQL pomocí otazníku (?) jako značky parametru pro každý parametr.

9. Klikněte na Aktualizovat. Když kliknete na Aktualizovat, transformace vytvoří sloupec pro každý parametr v kolekci externích sloupců a nastaví vlastnost DBParamInfoFlags.

10. Klikněte na kartu Vlastnosti vstupu a výstupu .

11. Rozbalte příkazový vstup OLE DB a potom rozbalte externí sloupce.

12. Ověřte, že externí sloupce obsahuje sloupec pro každý parametr v příkazu SQL. Názvy sloupců jsou Param_0, Param_1 atd.

    Názvy sloupců byste neměli měnit. Pokud změníte názvy sloupců, integrační služby vygenerují chybu ověření transformace příkazu OLE DB.

    Také byste neměli měnit datový typ. Vlastnost DataType každého sloupce je nastavena na správný datový typ.

13. Pokud externí sloupce neobsahují žádné sloupce, musíte je přidat ručně.

    • Klepněte na tlačítko Přidat sloupec jednou pro každý parametr v příkazu SQL.

    • Aktualizujte názvy sloupců tak, aby Param_0, Param_1 atd.

    • Zadejte hodnotu ve vlastnosti DBParamInfoFlags. Hodnota se musí shodovat s hodnotou v výčtu OLE DBPARAMFLAGSENUM. Další informace naleznete v referenční dokumentaci k OLE DB.

    • Zadejte datový typ sloupce a v závislosti na datovém typu zadejte znakovou stránku, délku, přesnost a měřítko sloupce.

    • Chcete-li odstranit nepoužívaný parametr, vyberte parametr v části Externí sloupce a klepněte na tlačítko Odebrat sloupec.

    • Klikněte na Mapování sloupců a namapujte sloupce v seznamu Dostupné vstupní sloupce na parametry v seznamu Dostupné cílové sloupce .

14. Klikněte na OK.

15. Chcete-li uložit aktualizovaný balíček, klepněte na tlačítko Uložit v nabídce Soubor .

Viz také

toku dat
Transformace integračních služeb