Data Catalog를 사용하려면 API를 사용하여 Data Catalog에서 만들거나 다른 Google Cloud 시스템에서 액세스할 리소스가 포함된 Google Cloud
프로젝트에서 Data Catalog API를 사용 설정해야 합니다. 이 프로젝트를 Data Catalog '리소스 프로젝트'라고 합니다.
일반적으로 프로젝트가 하나만 있는 경우 프로젝트에 포함된 모든 리소스에 액세스하려면 Data Catalog API만 사용 설정하면 됩니다.
Data Catalog 빠른 시작은 Data Catalog API가 사용 설정되고 액세스하는 BigQuery 테이블과 Data Catalog 태그 템플릿 및 태그가 포함된 프로젝트를 만드는 예시입니다.
여러 프로젝트에서 태그 템플릿 사용
태그 템플릿을 비롯하여 Google Cloud 의 모든 항목이 프로젝트에 있습니다. 하지만 다른 프로젝트에서 템플릿 사용을 승인하면 한 프로젝트의 태그 템플릿을 사용하여 다른 프로젝트의 태그를 만들 수 있습니다.
이렇게 하려면 TagTemplate Owner, Creator, User, Viewer IAM 역할을 사용합니다.
예를 들어 프로젝트 A가 프로젝트 B가 소유한 서비스 계정에 TagTemplate User 역할을 부여하면 프로젝트 B는 해당 템플릿을 사용하여 태그를 만들 수 있습니다. 프로젝트 A는 Tag Editor 역할을 사용하여 만든 태그를 수정할 수 있도록 동일한 서비스 계정을 승인할 수도 있습니다.
프로젝트 A가 프로젝트 B를 승인하지 않으면 프로젝트 B가 프로젝트 A의 태그 템플릿을 사용하여 자체 데이터 리소스에 태그를 지정할 수 없으며 자체 템플릿을 만들어야 합니다.
권장사항:둘 이상의 프로젝트와 관련된 경우 중앙 프로젝트에서 템플릿을 만드세요. 또한 데이터 거버넌스 팀은 공유 태그 템플릿을 소유하고 조직을 대신하여 유지해야 합니다.
Data Catalog 리소스 프로젝트 식별
다음 표에는 Data Catalog API와 Data Catalog API를 사용하도록 설정해야 하는 관련 리소스 프로젝트가 나와 있습니다.
템플릿이 생성될 때 태그 템플릿 컨테이너 프로젝트에서 Data Catalog API가 사용 설정되었기 때문에 API 호출을 위한 추가 작업이 필요하지 않습니다. 참고:태그의 parent 매개변수에 의해 식별된 프로젝트와 태그를 만들 때 사용하는 태그 템플릿은 동일한 조직에 속해야 합니다.
참고:
service account project: 애플리케이션 코드를 인증하기 위해 서비스 계정 사용자 인증 정보를 생성한 프로젝트입니다.
resource parameter: 요청과 연결된 리소스를 식별하는 API 요청에서 전달되는 매개변수입니다(예: tagTemplates.createparent 매개변수의 project-id 참조).
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-01-16(UTC)"],[[["\u003cp\u003eThe Data Catalog API must be enabled in a Google Cloud project, referred to as the "resource project," to create resources in Data Catalog or access them in other Google Cloud systems.\u003c/p\u003e\n"],["\u003cp\u003eTag templates, although created within a specific project, can be used to create tags in other projects if the appropriate IAM roles (\u003ccode\u003eTagTemplate Owner\u003c/code\u003e, \u003ccode\u003eCreator\u003c/code\u003e, \u003ccode\u003eUser\u003c/code\u003e, and \u003ccode\u003eViewer\u003c/code\u003e) are granted.\u003c/p\u003e\n"],["\u003cp\u003eThe project hosting the tag template is responsible for billing, even if the tags are utilized by other projects.\u003c/p\u003e\n"],["\u003cp\u003eFor optimal management, it's a best practice to create tag templates in a centralized project if they're intended for use across multiple projects, and a data governance team should manage them.\u003c/p\u003e\n"],["\u003cp\u003eThe necessary project in which the Data Catalog API must be enabled varies according to which Data Catalog APIs are being utilized, such as \u003ccode\u003eget/lookup/search\u003c/code\u003e vs.\u003ccode\u003ecreate/update/delete\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Data Catalog resource projects\n\nTo use Data Catalog, you must\n[enable the Data Catalog API](/apis/docs/enable-disable-apis#enable_an_api)\nin a Google Cloud\n[project](/resource-manager/docs/cloud-platform-resource-hierarchy#projects)\nthat contains the resources you will create in Data Catalog or\naccess in other Google Cloud systems with the API. We refer\nto this project as the Data Catalog \"resource project\".\n\nIn the common case, if you have only one project, you only need to enable\nthe Data Catalog API in it to access all the resources it contains.\nThe [Data Catalog quickstart](/data-catalog/docs/quickstarts/quickstart-search-tag)\nis an example of the creation of a project that has the Data Catalog\nAPI enabled and contains a BigQuery table you access as well as a\nData Catalog tag template and tag.\n\n### Using tag templates in multiple projects\n\nEverything in Google Cloud lives in a project, including your tag\ntemplates. However, you can use tag templates from one project to create tags in\nanother if you authorize the other project to use the templates.\nTo do this, use the `TagTemplate Owner`, `Creator`, `User`, and `Viewer` IAM\nroles.\n\nFor example: If project A grants the `TagTemplate User` role to a service\naccount owned by project B, this authorizes project B to create tags using its\ntemplates. Project A can also authorize the same service account to modify the\ncreated tags using the `Tag Editor` role.\n\nIf project A does not authorize project B, project B cannot tag its own data\nresources using project A's tag templates---it must create its own templates.\n| **Important:** The project that hosts your tag template is billed for tags created from it, even if they are used by other projects.\n\n**Best practice:** Create templates in a central project\nif they are relevant to more than one project. Also, your data governance team\nshould own the shared tag templates and maintain them on behalf of the\norganization.\n\n### Identifying the Data Catalog resource project\n\nThe following table lists Data Catalog APIs and the\nassociated resource project(s) where Data Catalog\nAPI must be enabled.\n\n**Notes:**\n\n- `service account project`: the project in which you have generated\n [service account credentials](/iam/docs/service-account-overview#what-are-service-accounts)\n to authenticate your application code.\n\n- `resource parameter`: the parameter passed in the API request that\n identifies the resource associated with the request (for example, see `project-id` in the\n [tagTemplates.create](/data-catalog/docs/reference/rest/v1beta1/projects.locations.tagTemplates/create)\n `parent` parameter).\n\nWhat's next\n-----------\n\n- Follow [Getting started with Data Catalog](/data-catalog/docs/quickstarts/quickstart-search-tag)."]]
