프로젝트 정보 액세스 및 수정

LookML 프로젝트 페이지에서는 Looker 인스턴스의 모든 LookML 프로젝트 목록을 제공하고 각 프로젝트의 모든 모델을 표시합니다.

LookML 프로젝트 페이지에 액세스하려면 다음 단계를 수행합니다.

1. 탐색 패널에서 개발 옵션을 선택하여 개발 패널을 엽니다.
2. 개발 패널에서 프로젝트를 선택합니다.

프로젝트 만들기

이 문서 페이지에서는 다음 방법 중 하나를 사용하여 프로젝트를 이미 만들었다고 가정합니다.

• Looker의 모델 만들기 페이지를 통한 모델 생성의 일부로
• Looker의 모델 만들기 페이지를 통해 빈 프로젝트로
• 프로젝트 생성을 위한 기존 프로세스 사용

기존 프로젝트 및 모델 보기

기존 프로젝트 목록을 보려면 LookML 프로젝트 페이지로 이동합니다.

프로덕션 모드의 LookML 프로젝트 페이지에는 생성되고 프로덕션으로 푸시된 프로젝트가 나열됩니다. 개발 모드에서는 프로덕션에서 가져온 프로젝트 또는 개발 모드에서 직접 생성한 프로젝트가 페이지에 나열됩니다. LookML 프로젝트 페이지에는 다음과 같은 기본 카테고리가 있습니다.

• 상단 섹션: 최상위 섹션에 나열되는 프로젝트가 생성되었으며 생성된 모델 및 뷰 파일이 포함될 수 있습니다. Looker 관리자이거나 프로젝트에서 하나 이상의 모델에 대한 develop 권한이 있는 경우 해당 프로젝트가 개발 패널과 페이지 상단 섹션에 표시됩니다.
• 대기 중인 프로젝트 섹션: 대기 중인 프로젝트 섹션에 나열된 프로젝트는 Looker 관리자가 모델에 대해 허용되는 연결을 구성했지만 Looker 개발자가 아직 LookML을 추가하지 않은 프로젝트입니다. develop 권한이 있으면 이 프로젝트를 볼 수 있습니다.
• Marketplace 프로젝트 섹션: Marketplace 프로젝트 섹션에 나열된 프로젝트는 애플리케이션, 블록 또는 플러그인이 설치되었을 때 Looker Marketplace를 사용하여 생성되었습니다.

새 프로젝트 또는 기존 프로젝트의 새 모델 지정에 대한 자세한 내용은 모델 생성 문서 페이지를 참고하세요.

프로젝트 목록 보기

LookML 프로젝트 페이지에는 각 프로젝트에 대해 다음 요소가 표시됩니다.

• 프로젝트 열: 프로젝트 이름. 각 프로젝트 옆에는 하나 이상의 모델이 나열되어 있을 수 있습니다. 프로젝트 이름을 선택하여 해당 프로젝트의 LookML로 이동합니다.
• 모델 열: 지정된 프로젝트의 LookML 모델 파일 집합. 개발 모드 환경이 프로덕션과 다른 경우 이 목록은 개발 모드와 프로덕션 모드 간에 변경될 수 있습니다. 예를 들어 개발 모드에서 아직 프로덕션에 푸시하지 않은 새 모델을 만들었을 수 있습니다.
• 구성 문제 열: 모델에 문제가 있으면 모델에 구성 문제를 나타내는 상태가 표시됩니다.
• 구성 버튼: 프로젝트에 구성 버튼을 사용할 수 있으면 해당 프로젝트의 모델 구성을 추가하거나 수정할 수 있습니다.

모델에 문제가 있으면 모델에 구성 문제를 나타내는 상태가 표시됩니다.

문제	설명
LookML 모델 파일이 아직 존재하지 않습니다	이 페이지에서 누군가 모델을 구성했지만 해당 모델을 위한 해당 LookML 파일을 아직 만들지 않은 경우 이 문제가 표시됩니다.
사용하려면 구성 필요	기존 프로젝트에 새 LookML 모델 파일을 만들었지만 이 페이지에서 아직 구성하지 않은 경우 이 문제가 표시됩니다.
'x' 연결이 존재하지 않습니다	모델 파일에 선언된 connection가 존재하지 않습니다(예: 누군가 철자를 잘못 입력했거나 아직 만들지 않은 경우).
'x' 모델은 'y' 연결을 사용할 수 없습니다	모델 파일에 선언된 connection는 이 페이지의 구성에 따라 허용되지 않습니다.
이름이 'x'인 모델이 이미 프로젝트 'y'에서 구성되어 있습니다	각각의 모델이 다른 프로젝트에 있더라도 모델 이름은 Looker 인스턴스 내에서 고유해야 합니다.

Marketplace 프로젝트 목록 보기

LookML 프로젝트 페이지의 Marketplace 프로젝트 섹션에는 Marketplace 애플리케이션, 블록 또는 플러그인 설치 중에 생성된 프로젝트가 나와 있습니다. 각 Marketplace 프로젝트의 목록에는 다음 요소가 포함됩니다.

• 목록: Looker Marketplace의 애플리케이션, 블록 또는 플러그인 목록에 대한 링크입니다.
• 프로젝트: 프로젝트의 이름. 프로젝트 이름을 클릭하여 LookML을 보거나 수정할 수 있습니다.
• LookML 보기 또는 LookML 수정 버튼: Marketplace 블록의 읽기 전용 코어 프로젝트의 LookML 보기 버튼을 선택하여 Marketplace 프로젝트로 이동할 수 있습니다. 또는 구성 프로젝트에 대해 LookML 수정(후자의 경우 맞춤설정 가능)을 사용할 수 있습니다. Marketplace 블록 맞춤설정에 대한 자세한 내용은 Looker Marketplace 블록 맞춤설정 문서 페이지를 참조하십시오.
• 모델: 지정된 프로젝트의 LookML 모델 파일 집합입니다.
• 구성 버튼: 프로젝트 목록 옆에 구성 버튼이 있으면 프로젝트의 모델 구성을 추가하거나 편집할 수 있습니다.

대기 중인 프로젝트 목록 보기

대기 중인 프로젝트 섹션에는 구성되었지만 아직 LookML이 생성 또는 수동으로 정의되지 않은 프로젝트와 모델이 포함되어 있습니다.

프로젝트가 존재하기 전에 모델을 구성하는 것은 manage_models 또는 manage_project_models 권한을 부여받지 않은 개발자가 있는 경우 유용합니다. 모델이 이미 구성되어 있으므로 이러한 개발자는 프로젝트와 모델을 만드는 즉시 쿼리를 실행할 수 있습니다. 프로젝트가 생성되면 프로젝트 목록이 LookML 프로젝트 페이지의 상단 섹션으로 이동합니다.

대기 중인 프로젝트 섹션에는 다음 요소가 포함되어 있습니다.

• 프로젝트 열: 이 섹션에는 구성되었지만 아직 생성되지 않은 프로젝트가 나열됩니다. 이 필드의 프로젝트 이름은 프로젝트의 의도된 이름입니다. 프로젝트 이름을 선택하여 프로젝트를 생성할 수 있는 새 프로젝트 페이지를 표시합니다. 새 프로젝트 페이지에 액세스하려면 개발 모드에 있어야 합니다.
• 모델 열: 모델 구성을 만들 때 지정된 모델 이름입니다.
• 허용된 연결 열: 모델 이름 오른쪽의 열에는 모델 구성이 생성될 때 이 모델에서 허용되는 연결이 표시됩니다.
• 구성 버튼: 구성 버튼을 사용하면 프로젝트 이름과 이 모델에 허용되는 연결을 변경할 수 있습니다.
• LookML 추가 버튼: LookML 추가 버튼을 클릭하면 LookML을 사용할 수 있도록 해당 프로젝트의 새 프로젝트 페이지가 열립니다. 여기에서 데이터베이스의 테이블 집합을 기반으로 LookML을 자동으로 생성할 수 있습니다.

모델 구성 추가 및 수정

기존 프로젝트 목록 옆에 구성 버튼이 있으면 프로젝트의 모델 구성을 추가하거나 수정할 수 있습니다.

모델에 구성이 없는 경우 구성을 클릭하면 Looker에 모델 구성 창이 표시됩니다. 모델 구성 창에서 모델 이름, 프로젝트 이름, 모델에 사용할 수 있는 연결을 지정할 수 있습니다.

연결 목록에는 모델 프로젝트와 함께 사용할 수 있는 연결만 포함됩니다. 모든 프로젝트에서 사용할 수 있도록 구성된 연결에는 (Instance wide) 라벨이 있습니다.

프로젝트 페이지 상단의 새 모델 구성 버튼을 클릭하여 모델 구성 창을 열 수도 있습니다. 이 시나리오에서는 모델 구성 창을 사용하여 새 모델을 만들고 구성할 수 있습니다. 새 모델에는 LookML이 없지만 연결과 연결됩니다. 이 프로세스를 완료하려면 모델 입력란에 모델의 새 이름을 입력하고 프로젝트 입력란을 새 이름으로 작성하거나 모델과 동일한 이름을 선택하고 연결을 선택한 다음 저장을 클릭합니다. 나중에 나 또는 다른 Looker 개발자가 새 프로젝트에 LookML을 추가하여 모델을 정의할 수 있습니다.

모델에 구성이 포함된 경우 구성을 클릭하면 Looker에 모델 구성 수정 창이 표시됩니다. 모델 구성 수정 창에서 모델에 사용할 수 있는 연결을 변경할 수 있습니다.

모델 구성을 수정할 때 모델 이름을 볼 수 있지만 이름은 변경할 수 없습니다. 모델 이름은 Looker IDE에서 모델 파일을 편집할 때 사용하는 파일 이름에 따라 지정됩니다.

프로젝트 필드에서 모델을 다른 프로젝트와 연결하도록 지정할 수 있습니다. 예를 들어 같은 이름의 모델을 포함하는 새 프로젝트를 만든 경우 모델 구성을 새 프로젝트의 모델과 연결하도록 전환할 수 있습니다.

허용된 연결 필드에서 모델이 특정 연결 목록을 사용하도록 제한하거나 모델이 모든 연결(현재 및 이후의 모든 연결)을 사용하도록 허용할 수 있습니다.

프로젝트 이름 변경

Looker 관리자가 LookML 프로젝트를 만들 때 관리자는 프로젝트 이름을 제공합니다. Looker에서 프로젝트 이름을 다음과 같은 방식으로 사용하므로 프로젝트 이름은 프로젝트의 영구 ID로 간주되어야 합니다.

• project_id가 매개변수로 있는 API 호출의 프로젝트를 식별합니다.
• Looker 인스턴스의 내부 데이터베이스에서 프로젝트를 식별합니다.
• 로컬 프로젝트 가져오기를 위한 프로젝트를 식별합니다.
• LookML 프로젝트 페이지에서 프로젝트를 표시합니다.
• Looker 탐색 패널의 개발 섹션에 프로젝트를 표시합니다.
• 프로젝트 파일 URL의 일부로 사용됩니다. 예를 들어 URL이 example.looker.com인 Looker 인스턴스에서 ecommerce라는 프로젝트의 프로젝트 매니페스트 파일은 https://example.looker.com/projects/ecommerce/files/manifest.lkml URL에서 찾을 수 있습니다.

Looker manage_models 권한이 있으면 프로젝트의 프로젝트 구성 페이지에서 LookML 프로젝트 이름을 변경할 수 있습니다. 관리자가 아닌 Looker 개발자는 프로젝트 구성 페이지를 볼 수 있지만 페이지에서 옵션을 변경할 수 없습니다.

프로젝트 이름을 바꾸려면 다음 단계를 수행합니다.

1. 개발 모드가 사용 설정되어 있는지 확인합니다.
2. Looker IDE에서 프로젝트로 이동합니다.
3. 프로젝트에서 IDE 탐색 메뉴의 설정 tune을 클릭하여 프로젝트 설정 패널을 엽니다.
4. 프로젝트 설정 패널에서 구성을 선택합니다.
5. 프로젝트 구성 아래의 이름 필드를 사용하여 프로젝트 이름을 편집합니다.
6. 프로젝트 구성 페이지에서 프로젝트 구성 저장을 클릭하여 새 프로젝트 이름을 저장합니다.

프로젝트 삭제

Looker 관리자는 프로젝트의 프로젝트 설정 페이지에서 기존 프로젝트를 삭제할 수 있습니다. 프로젝트 설정을 보려면 프로젝트를 열고 IDE 탐색 메뉴에서 설정 tune을 클릭합니다.

삭제된 프로젝트가 LookML 프로젝트 페이지의 프로젝트 섹션에 더 이상 표시되지 않지만 구성된 프로젝트 섹션에는 여전히 표시됩니다.

프로젝트 구성을 삭제하여 개발 환경에서 프로젝트를 완전히 삭제하려면 다음 안내를 따르십시오.

1. Looker IDE에서 프로젝트로 이동합니다.
2. 프로젝트에서 IDE 탐색 메뉴의 설정 tune을 클릭하여 프로젝트 설정 패널을 엽니다.
3. 프로젝트 설정 패널에서 구성을 선택하여 프로젝트 구성을 확인합니다.
4. 프로젝트 구성에서 프로젝트 삭제를 선택합니다.
5. 프로젝트 삭제 창에서 프로젝트가 삭제될 때 손실되는 동기화되지 않은 변경사항과 경고를 확인합니다.
6. 프로젝트를 삭제해야 하면 필드에 프로젝트 이름을 입력합니다. 작업을 취소하고 프로젝트로 돌아가려면 브라우저의 뒤로 버튼을 사용합니다.
7. <프로젝트 이름> 영구 삭제 버튼을 클릭합니다.