Používání atributů pomocí značek
Tento článek vysvětluje, jak pomocí vlastních a výchozích značek přiřazovat úlohy konkrétním pracovním prostorům, týmům, projektům a uživatelům.
Pokud chcete monitorovat náklady a přesně přiřazovat využití Azure Databricks k obchodním jednotkám a týmům vaší organizace (například pro vracení peněz), můžete označit pracovní prostory (skupiny prostředků) a výpočetní prostředky. Tyto značky se šíří do podrobných sestav analýzy nákladů, ke kterým máte přístup v portálu Azure.
Poznámka: Data značek se můžou replikovat globálně. Nepoužívejte názvy značek ani hodnoty, které by mohly ohrozit zabezpečení vašich prostředků. Nepoužívejte například názvy značek, které obsahují osobní nebo citlivé informace.
Tady je sestava podrobností faktury analýzy nákladů na webu Azure Portal, která podrobně popisuje náklady podle značky clusterid
za jednoměsíční období:
Označené objekty a prostředky
Objekt | Rozhraní označování (UI) | Rozhraní API (Tagging Interface) |
---|---|---|
Pracovní prostor | Azure Portal | Rozhraní API pro prostředky Azure |
Fond | Uživatelské rozhraní fondů v pracovním prostoru Azure Databricks | Rozhraní API fondu instancí |
Výpočetní prostředky pro všechny účely a úlohy | Výpočetní uživatelské rozhraní v pracovním prostoru Azure Databricks | Rozhraní API pro clustery |
SQL Warehouse | Uživatelské rozhraní SQL Warehouse v pracovním prostoru Azure Databricks | Rozhraní API skladů |
Upozorňující
Nepřiřazujte vlastní značku s klíčem Name
ke clusteru. Každý cluster má značku Name
, jejíž hodnota je nastavená službou Azure Databricks. Pokud změníte hodnotu přidruženou ke klíči Name
, azure Databricks už cluster nemůže sledovat. V důsledku toho se cluster nemusí po nečinnosti ukončit a bude nadále vyžadovat náklady na využití.
Výchozí značky
Azure Databricks přidá do výpočetních prostředků pro všechny účely následující výchozí značky:
Klíč značky | Hodnota |
---|---|
Vendor |
Konstantní hodnota: Databricks |
ClusterId |
Interní ID clusteru v Azure Databricks |
ClusterName |
Název clusteru |
Creator |
Uživatelské jméno (e-mailová adresa) uživatele, který cluster vytvořil |
V clusterech úloh používá Azure Databricks také následující výchozí značky:
Klíč značky | Hodnota |
---|---|
RunName |
Název úlohy |
JobId |
ID úlohy |
Azure Databricks přidá do všech fondů následující výchozí značky:
Klíč značky | Hodnota |
---|---|
Vendor |
Konstantní hodnota: Databricks |
DatabricksInstancePoolCreatorId |
Interní ID uživatele, který fond vytvořil, v Azure Databricks |
DatabricksInstancePoolId |
Interní ID fondu v Azure Databricks |
Na výpočetních prostředcích používaných monitorováním Lakehouse používá Azure Databricks také následující značky:
Klíč značky | Hodnota |
---|---|
LakehouseMonitoring |
true |
LakehouseMonitoringTableId |
ID monitorované tabulky |
LakehouseMonitoringWorkspaceId |
ID pracovního prostoru, ve kterém byl monitor vytvořen |
LakehouseMonitoringMetastoreId |
ID metastoru, kde existuje monitorovaná tabulka |
Označení bezserverových výpočetních úloh
Důležitý
Tato funkce je ve verzi Public Preview.
Pokud chcete uživatelům, skupinám nebo projektům přiřazovat využití výpočetních prostředků bez serveru, můžete použít zásady rozpočtu. Když je uživateli přiřazená zásada rozpočtu, jejich bezserverové využití se automaticky označí značkami zásad. Viz Použití bezserverového atributu se zásadami rozpočtu.
Šíření značek
Značky pracovních prostorů, fondů a clusterů jsou agregované službou Azure Databricks a šíří se do virtuálních počítačů Azure pro vytváření sestav analýzy nákladů. Značky fondů a clusterů se ale šíří odlišně od sebe.
Značky pracovního prostoru a fondu se agregují a přiřazují jako značky prostředků virtuálních počítačů Azure, které hostují fondy.
Značky pracovního prostoru a clusteru se agregují a přiřazují jako značky prostředků virtuálních počítačů Azure, které jsou hostiteli clusterů.
Při vytváření clusterů z fondů se na virtuální počítače rozšíří jenom značky pracovních prostorů a značky fondu. Značky clusteru se nerozšírují, aby se zachoval výkon spouštění clusteru fondu.
Řešení konfliktů značek
Pokud má vlastní značka clusteru, značku fondu nebo značku pracovního prostoru stejný název jako výchozí značka clusteru nebo fondu Azure Databricks, má vlastní značka předponu x_
při šíření.
Pokud je například pracovní prostor označený vendor = Azure Databricks
, bude tato značka v konfliktu s výchozí značkou vendor = Databricks
clusteru . Značky se proto rozšíří jako x_vendor = Azure Databricks
a vendor = Databricks
.
Omezení
- Rozšíření vlastních značek pracovních prostorů do Azure Databricks po jakékoli změně může trvat až jednu hodinu.
- Prostředku Azure je možné přiřadit maximálně 50 značek. Pokud celkový počet agregovaných značek tento limit překročí,
x_
značky s předponou se vyhodnocují v abecedním pořadí a ty, které překročí limit, budou ignorovány. Pokud jsou všechny značky s předponoux_
ignorovány a počet je stále nad limitem, zbývající značky se vyhodnocují v abecedním pořadí a ty, které překročí limit, se ignorují. - Klíče a hodnoty značek mohou obsahovat pouze písmena, mezery, čísla nebo znaky
+
,-
,=
,.
,_
,:
,/
,@
. Značky obsahující jiné znaky jsou neplatné. - Pokud změníte názvy klíčů nebo hodnoty značek, použijí se tyto změny až po restartování clusteru nebo rozšíření fondu.
- Pokud jsou vlastní značky clusteru v konfliktu s vlastními značkami fondu, cluster nejde vytvořit.
- Nově přidané značky pracovního prostoru se automaticky nepřenášejí na stávající výpočetní prostředky. Chcete-li nové tagy rozšířit, otevřete stránku podrobností výpočetního prostředku, klikněte na Upravita poté na Potvrdit a restartovat.
Osvědčené postupy označování
- Vzhledem k tomu, že značky mohou být zadány ručně, měla by vaše organizace standardizovat páry klíčů a hodnot. Databricks doporučuje vyvinout obchodní zásady pro pojmenování klíčových a hodnot, které můžete sdílet se všemi uživateli.
- Všechny prostředky by měly být označené obecnými klíči, které přiřazují použití k organizační jednotce nebo projektu. Například výpočetní zdroj úlohy vytvořený finančním týmem pro sestavení jejich ročního rozpočtu může zahrnovat značky
business-unit:finance
aproject:annual-budget
. - Podrobnější přehledy získáte tak, že značky přiřadíte pomocí klíčů s vysokou specificitou. Můžete například vytvořit klíče založené na rolích, produktech, službách nebo zákaznících.
- Pokud je to možné, správci pracovního prostoru by měli uplatnit štítky pomocí zásad pro správu výpočetních prostředků a rozpočtových zásad. Viz vynucení vlastních značek.