VYTVOŘIT KLASIFIKÁTOR PRACOVNÍ ZÁTĚŽE (Transact-SQL)

platí pro:azure Synapse Analytics

Vytváří klasifikační objekt pro použití při řízení zátěže. Klasifikátor přiřazuje příchozí požadavky do skupiny pracovních zátěží na základě parametrů specifikovaných v definici příkazu klasifikátoru. Klasifikátory jsou vyhodnocovány při každé zaslané žádosti. Pokud požadavek není přiřazen klasifikátoru, je přiřazen do výchozí skupiny zátěže. Výchozí skupinou zátěže je třída smallrc zdrojů.

Note

Chování klasifikace spravovaných identit (MI) se liší mezi dedikovaným SQL poolem v pracovních prostorech Azure Synapse a samostatným dedikovaným SQL poolem (dříve SQL DW). Zatímco samostatný dedikovaný SQL pool MI zachovává přiřazenou identitu, pracovní prostory Azure Synapse přidávají MI do role dbo. Tuto možnost nelze změnit. Role dbo je ve výchozím nastavení klasifikována jako smallrc. Vytvoření klasifikátoru pro roli dbo umožňuje přiřadit požadavky jiné skupině pracovních zátěží než smallrc. Pokud je samotné dbo příliš obecné na klasifikaci a má širší dopady, zvažte použití klasifikace založené na štítku, sezení nebo čase v kombinaci s klasifikací role dbo .

Transact-SQL konvence syntaxe

Syntax

CREATE WORKLOAD CLASSIFIER classifier_name
WITH
    ( WORKLOAD_GROUP = 'name'
    , MEMBERNAME = 'security_account'
    [ [ , ] WLM_LABEL = 'label' ]
    [ [ , ] WLM_CONTEXT = 'context' ]
    [ [ , ] START_TIME = 'HH:MM' ]
    [ [ , ] END_TIME = 'HH:MM' ]
    [ [ , ] IMPORTANCE = { LOW | BELOW_NORMAL | NORMAL | ABOVE_NORMAL | HIGH } ] )
[ ; ]

Note

Tato syntaxe není podporována bezserverovým fondem SQL ve službě Azure Synapse Analytics.

Arguments

classifier_name

Specifikuje název, kterým je klasifikátor pracovní zátěže identifikován. classifier_name je sysname. Tento parametr může mít až 128 znaků a musí být jedinečný v dané instanci.

WORKLOAD_GROUP = 'jméno'

Když jsou podmínky splněny pravidly klasifikátoru, pojmenujte požadavek na skupinu zátěže. Jménoje sysname. Tento parametr může mít až 128 znaků a musí být platným názvem pracovní skupiny v době vytvoření klasifikátoru.

Dostupné skupiny pracovních zátěží lze nalézt sys.workload_management_workload_groups zobrazení katalogu.

JMÉNO ČLENA = 'security_account'

Bezpečnostní účet použitý k klasifikaci proti. security_account je sysname, bez výchozího nastavení. security_account může být uživatel databáze, databázová role, Microsoft Entra přihlášení nebo Microsoft Entra skupina.

Note

Použijte user_name() funkci, když je připojena k systému, k ověření MEMBERNAME , kterou klasifikační proces použije k klasifikaci požadavku. Ověření pomocí MEMBERNAMEuser_name() této funkce může být užitečné při řešení problémů s Microsoft Entra ID nebo klasifikací principů služby. Pokud user_name() se vrátí dbo, můžete použít dbo jako nástroj MEMBERNAME pro klasifikaci požadavků. Všichni členové role dbo budou klasifikováni. Další klasifikační parametry, jako WLM_LABEL je nebo mohou WLM_CONTEXT být také použity ke specifické klasifikaci požadavků z více Microsoft Entra účtů, mapujících se na roli dbo.

Štítek_WLM

Specifikuje hodnotu štítku, podle které lze požadavek klasifikovat. Label je volitelný parametr typu nvarchar(255). Použijte v požadavku OPTION (LABEL) pro přizpůsobení konfiguraci klasifikátoru.

Příklady:

CREATE WORKLOAD CLASSIFIER wcELTLoads
WITH (
    WORKLOAD_GROUP = 'wgDataLoad',
    MEMBERNAME = 'ELTRole',
    WLM_LABEL = 'dimension_loads'
);
    
SELECT COUNT(*) FROM DimCustomer
OPTION (LABEL = 'dimension_loads');

WLM_CONTEXT

Specifikuje kontextovou hodnotu relace, podle které lze požadavek klasifikovat. WLM_CONTEXTje volitelný parametr typu nvarchar(255). Použijte sys.sp_set_session_context s názvem proměnné rovným před wlm_context odesláním požadavku pro nastavení kontextu relace.

Příklady:

CREATE WORKLOAD CLASSIFIER wcDataLoad
WITH (
    WORKLOAD_GROUP = 'wgDataLoad',
    MEMBERNAME = 'ELTRole',
    WLM_CONTEXT = 'dim_load'
);

--set session context
EXEC sys.sp_set_session_context @key = 'wlm_context', @value = 'dim_load';

--run multiple statements using the wlm_context setting
SELECT COUNT(*) FROM stg.daily_customer_load;
SELECT COUNT(*) FROM stg.daily_sales_load;

--turn off the wlm_context session setting
EXEC sys.sp_set_session_context @key = 'wlm_context', @value = NULL;

START_TIME a END_TIME

Specifikuje čas začátku a konec, podle kterého může být požadavek klasifikován. Obě START_TIME a mají END_TIMEHH:mm formát v časovém pásmu UTC. START_TIME a musí být specifikovány END_TIME společně.

Příklady:

CREATE WORKLOAD CLASSIFIER wcELTLoads
WITH (
    WORKLOAD_GROUP = 'wgDataLoads',
    MEMBERNAME = 'ELTRole',
    START_TIME = '22:00',
    END_TIME = '02:00'
);

DŮLEŽITOST = { NÍZKÁ | BELOW_NORMAL | NORMÁLNÍ | ABOVE_NORMAL | HIGH }

Specifikuje relativní význam žádosti. IMPORTANCE je jednou z následujících možností:

• LOW
• BELOW_NORMAL
• NORMAL (výchozí)
• ABOVE_NORMAL
• HIGH

Pokud IMPORTANCE není specifikováno, použije se nastavení důležitosti pracovní skupiny. Výchozí důležitost skupiny pracovních zátěží je NORMAL. Důležitost ovlivňuje pořadí, v jakém jsou požadavky plánovány, čímž dává první přístup ke zdrojům a zámkům.

Remarks

Maximální počet uživatelsky definovaných klasifikátorů je .100 Další konfigurace přesahující tento limit nejsou podporovány. Doporučujeme seskupit klasifikátory do společné kategorie pro efektivní aplikaci jediného nastavení pro více úloh nebo uživatelů.

Vážení klasifikačních parametrů

Požadavek může být porovnán s více klasifikátory. Existuje váha pro parametry klasifikátoru. Vyšší vážený klasifikátor párování se používá k přiřazení pracovní skupiny a důležitosti. Hodnocení je následující:

Parametr klasifikátoru	Weight
USER	64
ROLE	32
WLM_LABEL	16
WLM_CONTEXT	8
START_TIME/END_TIME	4

Zvažme následující konfigurace klasifikátorů.

CREATE WORKLOAD CLASSIFIER classifierA
WITH (
    WORKLOAD_GROUP = 'wgDashboards',
    MEMBERNAME = 'userloginA',
    IMPORTANCE = HIGH,
    WLM_LABEL = 'salereport'
);

CREATE WORKLOAD CLASSIFIER classifierB
WITH (
    WORKLOAD_GROUP = 'wgUserQueries',
    MEMBERNAME = 'userloginA',
    IMPORTANCE = LOW,
    START_TIME = '18:00',
    END_TIME = '07:00'
);

Uživatel userloginA je nakonfigurován pro oba klasifikátory. Pokud userloginA se spustí dotaz s označením salesreport rovným mezi 18:00 a 7:00 UTC, požadavek je klasifikován do wgDashboards skupiny pracovních zátěží s HIGH důležitostí. Očekáváním může být klasifikace požadavku na wgUserQueries s důležitostí LOW pro reportování mimo pracovní dobu, ale váha je WLM_LABEL vyšší než START_TIME/END_TIME. Vážení je classifierA (6480 pro uživatele, plus 16 pro WLM_LABEL). Vážení je classifierB (6468 pro uživatele, 4 pro START_TIME/END_TIME). V tomto případě můžete přidat WLM_LABEL k classifierB.

Pro více informací viz váhování pracovní zátěže.

Povolení

Vyžaduje oprávnění CONTROL DATABASE.

Examples

Následující příklad ukazuje, jak vytvořit klasifikátor pracovní zátěže s názvem wgcELTRole. Používá staticrc20 skupinu zátěže, uživatele ELTRole, a nastavuje DŮLEŽITOST na ABOVE_NORMAL.

CREATE WORKLOAD CLASSIFIER wgcELTRole
WITH (
    WORKLOAD_GROUP = 'staticrc20',
    MEMBERNAME = 'ELTRole',
    IMPORTANCE = ABOVE_NORMAL
);

Související obsah

• Azure Synapse Analytics Classification
• KLASIFIKÁTOR ZRUŠIT PRACOVNÍ ZÁTĚŽ (Transact-SQL)
• sys.workload_management_workload_classifiers (Transact-SQL)
• sys.workload_management_workload_classifier_details (Transact-SQL)