이 페이지에서는 Explore에 포함된
sql_table_name파라미터를 참조합니다.
sql_table_name은sql_table_name(뷰) 매개변수 문서 페이지에 설명된 대로 뷰의 일부로도 사용할 수 있습니다.
sql_table_name은sql_table_name(조인용) 매개변수 문서 페이지에 설명된 대로 조인의 일부로도 사용할 수 있습니다.
사용
explore: explore_name {
sql_table_name: table_name ;;
}
sql_table_name |
기본값
Explore의 뷰가 기반하는 데이터베이스 테이블
수락
데이터베이스 테이블의 이름
특별 규칙
|
정의
sql_table_name는 탐색에서 쿼리할 데이터베이스의 테이블을 설정합니다. 일반적으로 Explore의 이름이 지정된 뷰는 쿼리할 테이블을 정의합니다. 하지만 여러 테이블의 구조가 동일한 경우 동일한 뷰를 사용하여 모든 테이블을 설명할 수 있습니다. sql_table_name를 사용하면 이러한 테이블 중 사용할 테이블을 지정할 수 있습니다.
범위 지정 테이블 이름
테이블 이름만 사용하여 테이블을 참조하면 Looker는 Looker 관리자가 데이터베이스 연결 설정에서 구성한 기본 검색 경로 (데이터베이스 및 스키마)를 사용합니다. 자세한 내용은 이 페이지의 고려사항 섹션을 참고하세요.
데이터베이스 사용자의 기본 검색 경로에 없는 다른 데이터베이스 및 스키마의 테이블을 참조해야 하는 경우 <database_name>.<schema_name>.<table_name> 형식을 사용하여 테이블 이름을 범위 지정하여 다른 데이터베이스 또는 스키마를 가리킬 수 있습니다.
- 다른 스키마의 테이블을 참조하려면 이 페이지의 예에 표시된 것처럼
<schema_name>.<table_name>를 사용하세요. - 다른 데이터베이스의 테이블을 참조하려면 전체
<database_name>.<schema_name>.<table_name>를 사용합니다.
Google BigQuery 연결의 경우 <project_name>.<dataset_name>.<table_name> 형식을 사용하여 테이블 이름을 범위 지정하여 다른 프로젝트 및 데이터 세트의 테이블을 참조할 수 있습니다. 자세한 내용은 Google BigQuery 연결 문서 페이지를 참고하세요.
예시
이 예시에서는 customers Explore가 기본 데이터베이스/스키마의 customer_1 테이블을 사용하도록 합니다.
explore: customers {
sql_table_name: customer_1 ;;
}
이 예에서는 스키마 이름을 포함하도록 테이블 이름을 범위 지정 (<schema_name>.<table_name> 형식 사용)하여 customers Explore가 analytics 스키마의 customer_1 테이블을 사용하도록 합니다.
explore: customers {
sql_table_name: analytics.customer_1 ;;
}
고려사항
sql_table_name에서 참조하는 테이블은 현재 연결에서 액세스할 수 있어야 합니다.
sql_table_name 매개변수가 explore 객체 내에서 사용되면 해당 explore 객체는 model 객체에 포함됩니다. (이 페이지의 계층 구조에 이 관계 체인이 표시되어 있습니다.) 모델 객체에는 정의된 데이터베이스 connection이 있습니다. sql_table_name 파라미터에서 데이터베이스 테이블을 참조하는 경우 모델 파일에 지정된 연결 내에서 테이블에 액세스할 수 있어야 합니다.
기본 데이터베이스 및 스키마 (또는 Google BigQuery의 경우 결제 프로젝트 및 데이터 세트)는 데이터베이스 연결을 위해 Looker 관리자가 데이터베이스에 Looker 연결을 만들 때 정의합니다.
기본 테이블과 다르게 view의 이름을 지정하려면 view 수준에서 sql_table_name을 적용하세요.
이 페이지에 설명된 대로 explore 수준에서 sql_table_name를 사용하는 것은 일반적이지 않습니다. 동일한 view이 여러 테이블을 설명할 수 있는 경우에만 사용해야 합니다.
일반적인 방법은 기본 테이블 이름과 다르게 뷰 이름을 지정하려는 경우 view 수준에서 sql_table_name을 사용하는 것입니다.
즉, 다음과 같이 하지 마세요.
모델 파일
explore: customers {
sql_table_name: customer_1 ;;
}
방법
모델 파일
explore: customers { ... }
파일 보기
view: customers {
sql_table_name: customer_1 ;;
}