그래프 시각화

이 기능에 대한 지원을 요청하거나 의견을 제공하려면 bq-graph-preview-support@google.com으로 이메일을 보내세요.

BigQuery Graph 시각화에는 쿼리에서 반환한 그래프 요소나 그래프 스키마 요소가 표시됩니다. BigQuery Studio, Google Colab, Jupyter Notebook과 같은 노트북 환경에서 그래프를 시각화할 수 있습니다.

시각화를 사용하면 데이터 포인트 (노드)가 연결되는 방식(에지)을 파악할 수 있습니다. 데이터 포인트 수백 개로 구성된 테이블을 해석하기 어려울 수 있지만 그래프 시각화를 사용하면 패턴, 종속 항목, 이상치를 파악할 수 있습니다.

노트북 환경에서 쿼리 결과 및 스키마 시각화

BigQuery Studio, Google Colab, Jupyter 노트북과 같은 노트북 환경에서 그래프 쿼리 결과와 그래프 스키마를 시각화할 수 있습니다. 시각화는 IPython Magics로 구현됩니다.

그래프 쿼리 결과 시각화

노트북에서 쿼리 결과를 시각화하려면 다음 단계를 따르세요.

  1. 노트북 셀에서 다음 명령어를 실행하여 최신 BigQuery Magics 라이브러리를 설치합니다.

    !pip install bigquery_magics==0.12.1

  2. 노트북 환경에 BigQuery Graph 클라이언트 라이브러리가 설치되어 있는지 확인합니다.

  3. 노트북 셀에서 %%bigquery --graph 매직 명령어 다음에 GQL 쿼리를 사용합니다. 쿼리는 함수 TO_JSON 를 사용하여 그래프 요소를 JSON 형식으로 반환해야 합니다. 개별 노드와 에지 대신 그래프 경로를 반환하는 것이 좋습니다. 경로를 반환하면 다음과 같은 이점이 있습니다.

    • 경로에는 노드와 에지의 전체 데이터가 포함됩니다. 개별 노드와 에지를 반환하면 복잡한 쿼리의 시각화에서 일부 중간 노드와 에지를 사용할 수 없게 될 수 있습니다.

    • 경로를 반환하면 RETURN 문은 개별 노드와 에지를 반환하는 경우보다 덜 복잡해집니다.

  4. 셀을 실행합니다. 시각화가 셀의 출력 영역에 표시됩니다.

다음 샘플 쿼리는 사람, 계정, 상환된 대출을 찾은 후 결과를 노트북에 반환합니다.

%%bigquery --graph
GRAPH graph_db.FinGraph
MATCH
  p = ((person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(acount2:Account)<-[own2:Owns]-(person2:Person))
RETURN
  TO_JSON(p) AS path;

쿼리를 실행하면 출력 영역에 시각화가 표시됩니다. 세부정보 패널에는 노드 라벨과 에지 라벨의 요약과 각 라벨 수가 표시됩니다. 노드 또는 에지를 클릭하여 그래프를 탐색하고 속성, 이웃, 연결을 봅니다. 다음 이미지는 속성, 이웃, 연결을 보여줍니다.

쿼리 결과 시각화

BigQuery Graph 스키마 시각화

노드, 에지, 라벨, 속성과 같은 그래프의 구조는 BigQuery 테이블의 데이터를 그래프 요소에 매핑하는 스키마에 의해 정의됩니다. 그래프 정의는 입력 테이블을 사용하여 만든 스키마에 저장됩니다.

스키마로 만든 그래프를 시각화할 수 있습니다. 스키마를 시각화하면 포함된 노드 및 에지의 유형과 연결을 비롯한 그래프의 구조를 이해하는 데 도움이 됩니다. 이는 복잡한 그래프에 유용하며 그래프를 만드는 데 사용한 DDL 문만으로는 추론하기 어려울 수 있는 관계를 명확하게 보여줍니다. 다음 이미지는 그래프 스키마 시각화의 예를 보여줍니다.

그래프 스키마의 시각화

노트북에서 BigQuery Graph 스키마의 시각화를 보려면 다음 단계를 따르세요.

  1. 노트북 셀에서 다음 명령어를 실행하여 BigQuery Magics 라이브러리를 설치합니다.

    !pip install bigquery_magics==0.12.1

  2. 노트북 환경에 BigQuery Graph 클라이언트 라이브러리가 설치되어 있는지 확인합니다.

  3. 노트북 셀에서 %%bigquery --graph 매직 명령어 다음에 GQL 쿼리를 사용합니다. 쿼리는 함수 TO_JSON 를 사용하여 그래프 요소를 JSON 형식으로 반환해야 합니다.

  4. 셀을 실행합니다. 시각화가 셀의 출력 영역에 표시됩니다.

  5. 시각화 출력에서 스키마 스키마 뷰를 클릭합니다.

BigQuery Graph 시각화 문제 해결

다음 정보는 BigQuery Graph 시각화 문제와 동작을 해결하고 이해하는 데 도움이 됩니다.

BigQuery Graph 쿼리에 시각화가 표시되지 않음

문제: BigQuery Graph 쿼리를 실행했지만 테이블 형식으로만 표시됩니다.

원인: 쿼리에서 JSON 형식의 그래프 요소를 반환하지 않습니다.

예를 들어 다음 쿼리는 JSON 형식의 그래프 요소 대신 속성 값을 반환하므로 시각화될 수 없습니다.

GRAPH graph_db.FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name;

해결책:

그래프 요소를 JSON 형식으로 반환합니다. TO_JSON 자세한 내용은 BigQuery Graph 쿼리 결과 시각화를 참고하세요.

BigQuery Graph 쿼리 결과가 부분적으로 시각화됨

문제: 쿼리 결과 시각화에 쿼리 결과의 일부만 표시됩니다.

원인: 쿼리에서 2MB가 넘는 데이터를 반환합니다. 쿼리 시각화는 최대 2MB의 데이터를 표시할 수 있습니다.

해결책: 쿼리를 간소화하여 2MB 미만의 데이터를 반환합니다.

일부 그래프 요소가 BigQuery Graph 시각화에 표시되지 않음

문제: 시각화에 반환된 모든 노드와 에지가 포함되지만 일부 그래프 요소가 표시되지 않습니다.

원인: BigQuery Graph 시각화를 만드는 데 사용된 쿼리에서 그래프 경로 대신 개별 노드와 에지를 반환합니다.

해결책: 그래프 경로가 반환되도록 쿼리를 업데이트합니다.

다음 단계

  • BigQuery Graph에 대해 자세히 알아봅니다.
  • 그래프를 만들고 쿼리하는 방법을 알아봅니다.
  • 그래프 시각화 도구 및 통합에 대해 알아봅니다.