"use strict";(self.webpackChunkdocs_website=self.webpackChunkdocs_website||[]).push([[14400],{7653:(e,a,n)=>{n.d(a,{A:()=>t});const t={icon:{tag:"svg",attrs:{"fill-rule":"evenodd",viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M512 64c247.4 0 448 200.6 448 448S759.4 960 512 960 64 759.4 64 512 264.6 64 512 64zm127.98 274.82h-.04l-.08.06L512 466.75 384.14 338.88c-.04-.05-.06-.06-.08-.06a.12.12 0 00-.07 0c-.03 0-.05.01-.09.05l-45.02 45.02a.2.2 0 00-.05.09.12.12 0 000 .07v.02a.27.27 0 00.06.06L466.75 512 338.88 639.86c-.05.04-.06.06-.06.08a.12.12 0 000 .07c0 .03.01.05.05.09l45.02 45.02a.2.2 0 00.09.05.12.12 0 00.07 0c.02 0 .04-.01.08-.05L512 557.25l127.86 127.87c.04.04.06.05.08.05a.12.12 0 00.07 0c.03 0 .05-.01.09-.05l45.02-45.02a.2.2 0 00.05-.09.12.12 0 000-.07v-.02a.27.27 0 00-.05-.06L557.25 512l127.87-127.86c.04-.04.05-.06.05-.08a.12.12 0 000-.07c0-.03-.01-.05-.05-.09l-45.02-45.02a.2.2 0 00-.09-.05.12.12 0 00-.07 0z"}}]},name:"close-circle",theme:"filled"}},4732:(e,a,n)=>{n.d(a,{A:()=>l});var t=n(89379),i=n(96540),o=n(7653),r=n(89990),s=function(e,a){return i.createElement(r.A,(0,t.A)((0,t.A)({},e),{},{ref:a,icon:o.A}))};const l=i.forwardRef(s)},15680:(e,a,n)=>{n.d(a,{xA:()=>m,yg:()=>p});var t=n(96540);function i(e,a,n){return a in e?Object.defineProperty(e,a,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[a]=n,e}function o(e,a){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);a&&(t=t.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),n.push.apply(n,t)}return n}function r(e){for(var a=1;a<arguments.length;a++){var n=null!=arguments[a]?arguments[a]:{};a%2?o(Object(n),!0).forEach((function(a){i(e,a,n[a])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(n,a))}))}return e}function s(e,a){if(null==e)return{};var n,t,i=function(e,a){if(null==e)return{};var n,t,i={},o=Object.keys(e);for(t=0;t<o.length;t++)n=o[t],a.indexOf(n)>=0||(i[n]=e[n]);return i}(e,a);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(t=0;t<o.length;t++)n=o[t],a.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var l=t.createContext({}),c=function(e){var a=t.useContext(l),n=a;return e&&(n="function"==typeof e?e(a):r(r({},a),e)),n},m=function(e){var a=c(e.components);return t.createElement(l.Provider,{value:a},e.children)},u="mdxType",d={inlineCode:"code",wrapper:function(e){var a=e.children;return t.createElement(t.Fragment,{},a)}},g=t.forwardRef((function(e,a){var n=e.components,i=e.mdxType,o=e.originalType,l=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),u=c(n),g=i,p=u["".concat(l,".").concat(g)]||u[g]||d[g]||o;return n?t.createElement(p,r(r({ref:a},m),{},{components:n})):t.createElement(p,r({ref:a},m))}));function p(e,a){var n=arguments,i=a&&a.mdxType;if("string"==typeof e||i){var o=n.length,r=new Array(o);r[0]=g;var s={};for(var l in a)hasOwnProperty.call(a,l)&&(s[l]=a[l]);s.originalType=e,s[u]="string"==typeof e?e:i,r[1]=s;for(var c=2;c<o;c++)r[c]=n[c];return t.createElement.apply(null,r)}return t.createElement.apply(null,n)}g.displayName="MDXCreateElement"},43655:(e,a,n)=>{n.d(a,{A:()=>f});var t=n(96540),i=n(20053);const o="availabilityCard_P5od",r="managedIcon_AxXO",s="platform_wqXv",l="platformAvailable_Y8lN";var c=n(4732),m=n(89379);const u={icon:{tag:"svg",attrs:{viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm193.5 301.7l-210.6 292a31.8 31.8 0 01-51.7 0L318.5 484.9c-3.8-5.3 0-12.7 6.5-12.7h46.9c10.2 0 19.9 4.9 25.9 13.3l71.2 98.8 157.2-218c6-8.3 15.6-13.3 25.9-13.3H699c6.5 0 10.3 7.4 6.5 12.7z"}}]},name:"check-circle",theme:"filled"};var d=n(89990),g=function(e,a){return t.createElement(d.A,(0,m.A)((0,m.A)({},e),{},{ref:a,icon:u}))};const p=t.forwardRef(g);const y={icon:{tag:"svg",attrs:{viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M811.4 418.7C765.6 297.9 648.9 212 512.2 212S258.8 297.8 213 418.6C127.3 441.1 64 519.1 64 612c0 110.5 89.5 200 199.9 200h496.2C870.5 812 960 722.5 960 612c0-92.7-63.1-170.7-148.6-193.3zm36.3 281a123.07 123.07 0 01-87.6 36.3H263.9c-33.1 0-64.2-12.9-87.6-36.3A123.3 123.3 0 01140 612c0-28 9.1-54.3 26.2-76.3a125.7 125.7 0 0166.1-43.7l37.9-9.9 13.9-36.6c8.6-22.8 20.6-44.1 35.7-63.4a245.6 245.6 0 0152.4-49.9c41.1-28.9 89.5-44.2 140-44.2s98.9 15.3 140 44.2c19.9 14 37.5 30.8 52.4 49.9 15.1 19.3 27.1 40.7 35.7 63.4l13.8 36.5 37.8 10c54.3 14.5 92.1 63.8 92.1 120 0 33.1-12.9 64.3-36.3 87.7z"}}]},name:"cloud",theme:"outlined"};var h=function(e,a){return t.createElement(d.A,(0,m.A)((0,m.A)({},e),{},{ref:a,icon:y}))};const b=t.forwardRef(h),f=({saasOnly:e,ossOnly:a})=>t.createElement("div",{className:(0,i.A)(o,"card")},t.createElement("strong",null,"Feature Availability"),t.createElement("div",null,t.createElement("span",{className:(0,i.A)(s,!e&&l)},"Self-Hosted DataHub ",e?t.createElement(c.A,null):t.createElement(p,null))),t.createElement("div",null,t.createElement(b,{className:r}),t.createElement("span",{className:(0,i.A)(s,!a&&l)},"DataHub Cloud ",a?t.createElement(c.A,null):t.createElement(p,null))))},81147:(e,a,n)=>{n.r(a),n.d(a,{assets:()=>u,contentTitle:()=>c,default:()=>y,frontMatter:()=>l,metadata:()=>m,toc:()=>d});n(96540);var t=n(15680),i=n(43655);function o(e,a,n){return a in e?Object.defineProperty(e,a,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[a]=n,e}function r(e,a){return a=null!=a?a:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):function(e,a){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);a&&(t=t.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),n.push.apply(n,t)}return n}(Object(a)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(a,n))})),e}function s(e,a){if(null==e)return{};var n,t,i=function(e,a){if(null==e)return{};var n,t,i={},o=Object.keys(e);for(t=0;t<o.length;t++)n=o[t],a.indexOf(n)>=0||(i[n]=e[n]);return i}(e,a);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(t=0;t<o.length;t++)n=o[t],a.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}const l={title:"Domains",slug:"/domains",custom_edit_url:"https://github.com/datahub-project/datahub/blob/master/docs/domains.md"},c="Domains",m={unversionedId:"docs/domains",id:"version-1.1.0/docs/domains",title:"Domains",description:"Starting in version 0.8.25, DataHub supports grouping data assets into logical collections called Domains. Domains are curated, top-level folders or categories where related assets can be explicitly grouped. Management of Domains can be centralized, or distributed out to Domain owners Currently, an asset can belong to only one Domain at a time.",source:"@site/versioned_docs/version-1.1.0/docs/domains.md",sourceDirName:"docs",slug:"/domains",permalink:"/docs/1.1.0/domains",draft:!1,editUrl:"https://github.com/datahub-project/datahub/blob/master/docs/domains.md",tags:[],version:"1.1.0",frontMatter:{title:"Domains",slug:"/domains",custom_edit_url:"https://github.com/datahub-project/datahub/blob/master/docs/domains.md"},sidebar:"overviewSidebar",previous:{title:"Dataset Usage & Query History",permalink:"/docs/1.1.0/features/dataset-usage-and-query-history"},next:{title:"Incidents",permalink:"/docs/1.1.0/incidents/incidents"}},u={},d=[{value:"Domains Setup, Prerequisites, and Permissions",id:"domains-setup-prerequisites-and-permissions",level:2},{value:"Using Domains",id:"using-domains",level:2},{value:"Creating a Domain",id:"creating-a-domain",level:3},{value:"Advanced: Setting a Custom Domain id",id:"advanced-setting-a-custom-domain-id",level:4},{value:"Assigning an Asset to a Domain",id:"assigning-an-asset-to-a-domain",level:3},{value:"UI-Based Assignment",id:"ui-based-assignment",level:4},{value:"Ingestion-time Assignment",id:"ingestion-time-assignment",level:4},{value:"Searching by Domain",id:"searching-by-domain",level:3},{value:"Additional Resources",id:"additional-resources",level:2},{value:"Videos",id:"videos",level:3},{value:"GraphQL",id:"graphql",level:3},{value:"Examples",id:"examples",level:4},{value:"Create a Nested Domain",id:"create-a-nested-domain",level:2},{value:"DataHub Blog",id:"datahub-blog",level:3},{value:"FAQ and Troubleshooting",id:"faq-and-troubleshooting",level:2},{value:"Related Features",id:"related-features",level:3}],g={toc:d},p="wrapper";function y(e){var{components:a}=e,n=s(e,["components"]);return(0,t.yg)(p,r(function(e){for(var a=1;a<arguments.length;a++){var n=null!=arguments[a]?arguments[a]:{},t=Object.keys(n);"function"==typeof Object.getOwnPropertySymbols&&(t=t.concat(Object.getOwnPropertySymbols(n).filter((function(e){return Object.getOwnPropertyDescriptor(n,e).enumerable})))),t.forEach((function(a){o(e,a,n[a])}))}return e}({},g,n),{components:a,mdxType:"MDXLayout"}),(0,t.yg)("h1",{id:"domains"},"Domains"),(0,t.yg)(i.A,{mdxType:"FeatureAvailability"}),(0,t.yg)("p",null,"Starting in version ",(0,t.yg)("inlineCode",{parentName:"p"},"0.8.25"),", DataHub supports grouping data assets into logical collections called ",(0,t.yg)("strong",{parentName:"p"},"Domains"),". Domains are curated, top-level folders or categories where related assets can be explicitly grouped. Management of Domains can be centralized, or distributed out to Domain owners Currently, an asset can belong to only one Domain at a time."),(0,t.yg)("h2",{id:"domains-setup-prerequisites-and-permissions"},"Domains Setup, Prerequisites, and Permissions"),(0,t.yg)("p",null,"What you need to create and add domains:"),(0,t.yg)("ul",null,(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("strong",{parentName:"li"},"Manage Domains")," platform privilege to add domains at the entity level")),(0,t.yg)("p",null,"You can create this privileges by creating a new ",(0,t.yg)("a",{parentName:"p",href:"/docs/1.1.0/authorization/policies"},"Metadata Policy"),"."),(0,t.yg)("h2",{id:"using-domains"},"Using Domains"),(0,t.yg)("h3",{id:"creating-a-domain"},"Creating a Domain"),(0,t.yg)("p",null,"To create a Domain, first navigate to the ",(0,t.yg)("strong",{parentName:"p"},"Domains")," tab in the top-right menu of DataHub."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/domains-tab.png"})),(0,t.yg)("p",null,"Once you're on the Domains page, you'll see a list of all the Domains that have been created on DataHub. Additionally, you can\nview the number of entities inside each Domain."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master/imgs/list-domains.png"})),(0,t.yg)("p",null,"To create a new Domain, click '+ New Domain'."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/create-domain.png"})),(0,t.yg)("p",null,"Inside the form, you can choose a name for your Domain. Most often, this will align with your business units or groups, for example\n'Platform Engineering' or 'Social Marketing'. You can also add an optional description. Don't worry, this can be changed later."),(0,t.yg)("h4",{id:"advanced-setting-a-custom-domain-id"},"Advanced: Setting a Custom Domain id"),(0,t.yg)("p",null,"Click on 'Advanced' to show the option to set a custom Domain id. The Domain id determines what will appear in the DataHub 'urn' (primary key)\nfor the Domain. This option is useful if you intend to refer to Domains by a common name inside your code, or you want the primary\nkey to be human-readable. Proceed with caution: once you select a custom id, it cannot be easily changed."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/set-domain-id.png"})),(0,t.yg)("p",null,"By default, you don't need to worry about this. DataHub will auto-generate a unique Domain id for you."),(0,t.yg)("p",null,"Once you've chosen a name and a description, click 'Create' to create the new Domain."),(0,t.yg)("h3",{id:"assigning-an-asset-to-a-domain"},"Assigning an Asset to a Domain"),(0,t.yg)("p",null,"You can assign assets to Domain using the UI or programmatically using the API or during ingestion."),(0,t.yg)("h4",{id:"ui-based-assignment"},"UI-Based Assignment"),(0,t.yg)("p",null,"To assign an asset to a Domain, simply navigate to the asset's profile page. At the bottom left-side menu bar, you'll\nsee a 'Domain' section. Click 'Set Domain', and then search for the Domain you'd like to add to. When you're done, click 'Add'."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/set-domain.png"})),(0,t.yg)("p",null,"To remove an asset from a Domain, click the 'x' icon on the Domain tag."),(0,t.yg)("blockquote",null,(0,t.yg)("p",{parentName:"blockquote"},"Notice: Adding or removing an asset from a Domain requires the ",(0,t.yg)("inlineCode",{parentName:"p"},"Edit Domain")," Metadata Privilege, which can be granted\nby a ",(0,t.yg)("a",{parentName:"p",href:"/docs/1.1.0/authorization/policies"},"Policy"),".")),(0,t.yg)("h4",{id:"ingestion-time-assignment"},"Ingestion-time Assignment"),(0,t.yg)("p",null,"All SQL-based ingestion sources support assigning domains during ingestion using the ",(0,t.yg)("inlineCode",{parentName:"p"},"domain")," configuration. Consult your source's configuration details page (e.g. ",(0,t.yg)("a",{parentName:"p",href:"/docs/1.1.0/generated/ingestion/sources/snowflake"},"Snowflake"),"), to verify that it supports the Domain capability."),(0,t.yg)("admonition",{type:"note"},(0,t.yg)("p",{parentName:"admonition"},"Assignment of domains during ingestion will overwrite domains that you have assigned in the UI. A single table can only belong to one domain.")),(0,t.yg)("p",null,"Here is a quick example of a snowflake ingestion recipe that has been enhanced to attach the ",(0,t.yg)("strong",{parentName:"p"},"Analytics")," domain to all tables in the ",(0,t.yg)("strong",{parentName:"p"},"long_tail_companions")," database in the ",(0,t.yg)("strong",{parentName:"p"},"analytics")," schema, and the ",(0,t.yg)("strong",{parentName:"p"},"Finance")," domain to all tables in the ",(0,t.yg)("strong",{parentName:"p"},"long_tail_companions")," database in the ",(0,t.yg)("strong",{parentName:"p"},"ecommerce")," schema."),(0,t.yg)("pre",null,(0,t.yg)("code",{parentName:"pre",className:"language-yaml"},'source:\n  type: snowflake\n  config:\n    username: ${SNOW_USER}\n    password: ${SNOW_PASS}\n    account_id:\n    warehouse: COMPUTE_WH\n    role: accountadmin\n    database_pattern:\n      allow:\n        - "long_tail_companions"\n    schema_pattern:\n      deny:\n        - information_schema\n    profiling:\n      enabled: False\n    domain:\n      Analytics:\n        allow:\n          - "long_tail_companions.analytics.*"\n      Finance:\n        allow:\n          - "long_tail_companions.ecommerce.*"\n')),(0,t.yg)("admonition",{type:"note"},(0,t.yg)("p",{parentName:"admonition"},"When bare domain names like ",(0,t.yg)("inlineCode",{parentName:"p"},"Analytics")," is used, the ingestion system will first check if a domain like ",(0,t.yg)("inlineCode",{parentName:"p"},"urn:li:domain:Analytics")," is provisioned, failing that; it will check for a provisioned domain that has the same name. If we are unable to resolve bare domain names to provisioned domains, then ingestion will refuse to proceeed until the domain is provisioned on DataHub.")),(0,t.yg)("p",null,"You can also provide fully-qualified domain names to ensure that no ingestion-time domain resolution is needed. For example, the following recipe shows an example using fully qualified domain names:"),(0,t.yg)("pre",null,(0,t.yg)("code",{parentName:"pre",className:"language-yaml"},'source:\n  type: snowflake\n  config:\n    username: ${SNOW_USER}\n    password: ${SNOW_PASS}\n    account_id:\n    warehouse: COMPUTE_WH\n    role: accountadmin\n    database_pattern:\n      allow:\n        - "long_tail_companions"\n    schema_pattern:\n      deny:\n        - information_schema\n    profiling:\n      enabled: False\n    domain:\n      "urn:li:domain:6289fccc-4af2-4cbb-96ed-051e7d1de93c":\n        allow:\n          - "long_tail_companions.analytics.*"\n      "urn:li:domain:07155b15-cee6-4fda-b1c1-5a19a6b74c3a":\n        allow:\n          - "long_tail_companions.ecommerce.*"\n')),(0,t.yg)("h3",{id:"searching-by-domain"},"Searching by Domain"),(0,t.yg)("p",null,"Once you've created a Domain, you can use the search bar to find it."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/search-domain.png"})),(0,t.yg)("p",null,"Clicking on the search result will take you to the Domain's profile, where you\ncan edit its description, add / remove owners, and view the assets inside the Domain."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/domain-entities.png"})),(0,t.yg)("p",null,"Once you've added assets to a Domain, you can filter search results to limit to those Assets\nwithin a particular Domain using the left-side search filters."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/search-by-domain.png"})),(0,t.yg)("p",null,"On the homepage, you'll also find a list of the most popular Domains in your organization."),(0,t.yg)("p",{align:"center"},(0,t.yg)("img",{width:"70%",src:"https://raw.githubusercontent.com/datahub-project/static-assets/master//imgs/browse-domains.png"})),(0,t.yg)("h2",{id:"additional-resources"},"Additional Resources"),(0,t.yg)("h3",{id:"videos"},"Videos"),(0,t.yg)("p",null,(0,t.yg)("strong",{parentName:"p"},"Supercharge Data Mesh with Domains in DataHub")),(0,t.yg)("p",{align:"center"},(0,t.yg)("iframe",{width:"560",height:"315",src:"https://www.youtube.com/embed/CyvujJWV-8A",title:"YouTube video player",frameborder:"0",allow:"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture",allowfullscreen:!0})),(0,t.yg)("h3",{id:"graphql"},"GraphQL"),(0,t.yg)("ul",null,(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/graphql/queries#domain"},"domain")),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/graphql/queries#listdomains"},"listDomains")),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/graphql/mutations#createdomain"},"createDomains")),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/graphql/mutations#setdomain"},"setDomain")),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/graphql/mutations#unsetdomain"},"unsetDomain"))),(0,t.yg)("h4",{id:"examples"},"Examples"),(0,t.yg)("p",null,(0,t.yg)("strong",{parentName:"p"},"Creating a Domain")),(0,t.yg)("pre",null,(0,t.yg)("code",{parentName:"pre",className:"language-graphql"},'mutation createDomain {\n  createDomain(\n    input: { name: "My New Domain", description: "An optional description" }\n  )\n}\n')),(0,t.yg)("p",null,"This query will return an ",(0,t.yg)("inlineCode",{parentName:"p"},"urn")," which you can use to fetch the Domain details."),(0,t.yg)("h2",{id:"create-a-nested-domain"},"Create a Nested Domain"),(0,t.yg)("pre",null,(0,t.yg)("code",{parentName:"pre",className:"language-graphql"},'mutation createDomain {\n  createDomain(\n    input: {\n      name: "Verticals"\n      description: "An optional description"\n      parentDomain: "urn:li:domain:marketing"\n    }\n  )\n}\n')),(0,t.yg)("p",null,'This query will create a new domain, "Verticals", under the "Marketing" domain.'),(0,t.yg)("p",null,(0,t.yg)("strong",{parentName:"p"},"Fetching a Domain by Urn")),(0,t.yg)("pre",null,(0,t.yg)("code",{parentName:"pre",className:"language-graphql"},'query getDomain {\n  domain(urn: "urn:li:domain:engineering") {\n    urn\n    properties {\n      name\n      description\n    }\n    entities {\n      total\n    }\n  }\n}\n')),(0,t.yg)("p",null,(0,t.yg)("strong",{parentName:"p"},"Adding a Dataset to a Domain")),(0,t.yg)("pre",null,(0,t.yg)("code",{parentName:"pre",className:"language-graphql"},'mutation setDomain {\n  setDomain(\n    entityUrn: "urn:li:dataset:(urn:li:dataPlatform:hdfs,SampleHdfsDataset,PROD)"\n    domainUrn: "urn:li:domain:engineering"\n  )\n}\n')),(0,t.yg)("blockquote",null,(0,t.yg)("p",{parentName:"blockquote"},"Pro Tip! You can try out the sample queries by visiting ",(0,t.yg)("inlineCode",{parentName:"p"},"<your-datahub-url>/api/graphiql"),".")),(0,t.yg)("h3",{id:"datahub-blog"},"DataHub Blog"),(0,t.yg)("ul",null,(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"https://medium.com/datahub-project/just-shipped-ui-based-ingestion-data-domains-containers-and-more-f1b1c90ed3a"},"Just Shipped: UI-Based Ingestion, Data Domains & Containers, Tableau support, and MORE!"))),(0,t.yg)("h2",{id:"faq-and-troubleshooting"},"FAQ and Troubleshooting"),(0,t.yg)("p",null,(0,t.yg)("strong",{parentName:"p"},"What is the difference between DataHub Domains, Tags, and Glossary Terms?")),(0,t.yg)("p",null,"DataHub supports Tags, Glossary Terms, & Domains as distinct types of Metadata that are suited for specific purposes:"),(0,t.yg)("ul",null,(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("strong",{parentName:"li"},"Tags"),": Informal, loosely controlled labels that serve as a tool for search & discovery. Assets may have multiple tags. No formal, central management."),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("strong",{parentName:"li"},"Glossary Terms"),": A controlled vocabulary, with optional hierarchy. Terms are typically used to standardize types of leaf-level attributes (i.e. schema fields) for governance. E.g. (EMAIL_PLAINTEXT)"),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("strong",{parentName:"li"},"Domains"),": A set of top-level categories. Usually aligned to business units / disciplines to which the assets are most relevant. Central or distributed management. Single Domain assignment per data asset.")),(0,t.yg)("h3",{id:"related-features"},"Related Features"),(0,t.yg)("ul",null,(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/glossary/business-glossary"},"Glossary Terms")),(0,t.yg)("li",{parentName:"ul"},(0,t.yg)("a",{parentName:"li",href:"/docs/1.1.0/tags"},"Tags"))))}y.isMDXComponent=!0}}]);