sql_table_name (조인)

이 페이지에서는 join의 일부인 sql_table_name 파라미터를 참조합니다.

sql_table_name은 sql_table_name (뷰) 매개변수 문서 페이지에 설명된 대로 뷰의 일부로도 사용할 수 있습니다.

sql_table_name은 Explore의 일부로도 사용할 수 있으며, 이에 대한 설명은 sql_table_name (Explore용) 매개변수 문서 페이지를 참고하세요.

사용

explore: view_name {
  join: view_name {
    sql_table_name: table_name ;;
  }
}
계층 구조
explore
join
sql_table_name
기본값
없음

수락
데이터베이스의 테이블 이름

특별 규칙

정의

일반적으로 join이 기반으로 하는 뷰는 쿼리할 테이블을 정의합니다.

sql_table_name를 사용하여 join에서 쿼리할 데이터베이스의 테이블을 설정할 수 있습니다. 일반적이지는 않지만 여러 테이블의 스키마가 동일한 경우 유용할 수 있습니다. 동일한 뷰를 사용하여 모든 테이블을 설명할 수 있기 때문입니다. sql_table_name를 사용하면 조인하는 뷰에서 사용할 테이블을 지정할 수 있습니다. 이러한 상황에서는 extends 또는 세부검색을 사용하는 것이 좋습니다.

범위 지정 테이블 이름

테이블 이름만 사용하여 테이블을 참조하면 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 조인이 기본 스키마의 customer_1 테이블을 사용하도록 합니다.

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

이 예에서는 스키마 이름을 포함하도록 테이블 이름을 범위 지정 (<schema_name>.<table_name> 형식 사용)하여 customers 조인이 analytics 스키마의 customer_1 테이블을 사용하도록 합니다.

explore: orders {
  join: customers {
    sql_table_name: analytics.customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

고려사항

sql_table_name에서 참조하는 테이블은 현재 연결에서 액세스할 수 있어야 합니다.

sql_table_name 매개변수가 join 객체 내에서 사용되면 해당 join 객체는 explore 객체 내에 정의되며, 이 객체는 model 객체에 포함됩니다. (이 페이지의 계층 구조에 이 관계 체인이 표시되어 있습니다.) 모델 객체에는 정의된 데이터베이스 connection이 있습니다. sql_table_name 파라미터에서 데이터베이스 테이블을 참조하는 경우 모델 파일에 지정된 연결 내에서 테이블에 액세스할 수 있어야 합니다.

기본 데이터베이스 및 스키마 (또는 Google BigQuery의 경우 결제 프로젝트 및 데이터 세트)는 데이터베이스 연결을 위해 Looker 관리자가 데이터베이스에 Looker 연결을 만들 때 정의합니다.

기본 테이블과 다른 이름으로 join의 이름을 지정하려면 뷰 수준에서 sql_table_name을 적용하세요.

이 페이지에 설명된 대로 join 수준에서 sql_table_name를 사용하는 것은 일반적이지 않습니다. 동일한 뷰가 여러 테이블을 설명할 수 있는 경우에만 사용해야 합니다.

일반적인 방법은 view 수준에서 sql_table_name을 사용하여 기본 테이블 이름과 다른 이름으로 뷰 이름을 지정하는 것입니다.

코드가 다음과 같이 바뀝니다.

모델 파일

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}}

다음 단계를 따르세요.

모델 파일

explore: orders {
  join: customers {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

파일 보기

view: customers {
  sql_table_name: customer_1 ;;
}