Insights 관리 명령

Insights 관리 명령을 사용하면 사용자가 그의 데이터 시스템에 대한 더 많은 제어권을 표시하거나 추가 정보를 수집할 수 있습니다. 명령은 두 가지 기본 범주로 나뉩니다.

1. 관리 - 이러한 명령을 사용하면 쿼리, 명령, 보존 및 보존 변경에 대한 자세한 정보를 볼 수 있습니다.
2. 데이터 제어 - 이 범주의 명령을 사용하면 사용자 지정 테이블을 만들고 삭제하며, 로컬 및 클라우드 데이터를 수집하고, DB에서 데이터를 제거할 수 있습니다.

참고 항목

2023년 12월 11일부터 PlayFab Insights 관리는 더 이상 사용되지 않습니다. 앞으로는 ADX(Azure Data Explorer) 연결을 사용하여 성능과 비용을 관리하는 것이 좋습니다. 타이틀이 여전히 Insights를 사용하는 경우 이 문서를 계속 읽어 관리 명령 세부 정보를 확인하세요. 자세한 내용은 인사이트 사용 중단 블로그를 참조하세요.

일부 명령은 평가 모드에서 사용할 수 없습니다.

범주	명령
관리	.show queries .show running queries .show commands-and-queries .show table policy retention .alter table policy retention
데이터 제어	.create table .drop table .set .append .set-or-append .set-or-replace .ingest into table .purge table

관리

.show queries
사용자, 다른 사용자 또는 모든 사용자가 현재 실행 중인 쿼리 목록을 반환합니다.
사용법: .show queries
예: .show queries | where StartedOn > ago(1d)
이 명령은 말일에 실행된 모든 쿼리를 표시합니다.

.show running queries
현재 실행 중인 모든 쿼리를 표시합니다.
사용법: .show running queries
예: .show running queries
이 명령은 현재 실행 중인 모든 쿼리를 보여 줍니다.

.show database policy caching
데이터베이스의 현재 캐싱 정책을 표시합니다.
사용법: .show database DatabaseName policy caching
예: .show database myDatabase policy caching
이 명령은 지정된 데이터베이스의 현재 캐싱 정책을 표시합니다.

.show table policy caching
테이블의 현재 캐싱 정책을 표시합니다.
사용법: .show database DatabaseName.TableName policy caching
예: .show database myDatabase.myTable policy caching
이 명령은 지정된 테이블에 대한 현재 캐싱 정책을 표시합니다.

.show commands-and-queries
최종 상태에 도달한 관리자 명령 및 쿼리가 있는 테이블을 반환합니다. 이러한 명령 및 쿼리는 30일 동안 쿼리할 수 있습니다.
사용법: .show commands-and-queries
예: .show commands-and-queries | where StartedOn > ago(1d) | where State != "Completed"
이 명령은 마지막 날에 실패한 모든 명령 및 쿼리를 표시합니다.

.show table policy retention
클러스터 및 데이터베이스 규칙을 고려한 테이블의 유효한 보존 정책을 표시합니다.
사용법: .show table(s) (<table_name> [, ...]) policy retention
예: .show table ['events.all'] policy retention
이 명령은 "events.all" 테이블의 최신 보존 정책을 표시합니다.

.alter table policy retention (소비 가격 책정 모델의 계정으로 제한됨)
하나 이상의 테이블에 대한 현재 보존 정책을 <retention_policy>로 변경합니다.
사용법: .alter tables (<table_name> [, ...]) policy retention <retention_policy>
예: .alter table ['events.all'] policy retention softdelete = 90d
이 명령은 "events.all" 테이블의 데이터를 90일 후에 테이블에서 제거하도록 설정합니다.

데이터 제어

.create table (성능 수준 2 이상으로 제한됨)
빈 테이블을 새로 만듭니다. 명령은 특정 데이터베이스의 컨텍스트에서 실행되어야 합니다. 테이블이 이미 있는 경우 명령을 입력하면 성공이 반환됩니다.
사용법: .create table TableName ([columnName:columnType], ...)
예: .create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)
이 명령은 열이 4개인 "custom.logs"라는 새 테이블을 만듭니다. 중요 사용자 지정 테이블은 "custom."으로 시작해야 합니다.

.drop table (성능 수준 2 이상으로 제한됨)
지정된 테이블을 삭제합니다. 참고: 이 작업은 실행 취소할 수 없습니다.
사용법: .drop table TableName [ifexists]
예: .drop table ['custom.logs']
이 명령은 "custom.logs"라는 테이블을 삭제합니다.

.set (성능 수준 2 이상으로 제한됨)
쿼리 또는 명령의 결과가 담긴 테이블이 만들어집니다.
사용법: .set TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
예: .set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
이 명령은 위의 쿼리 결과를 포함하는 테이블 "custom.recentEvents"를 만듭니다.

.append (성능 수준 2 이상으로 제한됨)
기존 테이블에 쿼리 또는 명령의 결과를 추가합니다.
사용법: .append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
예: .append [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
이 명령은 위의 쿼리 결과와 함께 기존 테이블 "custom.recentEvents"에 추가합니다.

.set-or-append (성능 수준 2 이상으로 제한됨)
테이블을 만들거나 테이블에 쿼리 또는 명령의 결과를 추가합니다.
사용법: .set-or-append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
예: .set-or-append [‘custom.weekEvents’] <| [‘events.all’] | where Timestamp > now() – time(7d)
이 명령은 위 쿼리의 데이터를 테이블 "custom.weekEvents"에 추가합니다. 테이블이 없으면 만듭니다.

.set-or-replace (성능 수준 2 이상으로 제한됨)
테이블이 있는 경우 테이블의 데이터를 대체하거나(기존 데이터 조각 삭제) 테이블이 없는 경우 대상 테이블을 만듭니다. 테이블 스키마는 extend_schema 또는 recreate_schema 수집 속성 중 하나가 true로 설정되지 않는 한 유지됩니다. 스키마가 수정된 경우 자체 트랜잭션에서 실제 데이터 수집 전에 수정이 수행되므로 데이터를 수집하지 못하는 것이 스키마가 수정되지 않았음을 의미하지는 않습니다.
사용법: .set-or-replace TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
예: .set-or-replace [‘custom.dayEvents’] <| [‘events.all’] | where Timestamp > now() – time(1d)
이 명령은 테이블 "custom.dayEvents"의 데이터를 위의 쿼리로 바꿉니다.

.ingest into (성능 수준 2 이상으로 제한됨)
하나 이상의 클라우드 스토리지 아티팩트에서 데이터를 "끌어와서" 테이블에 데이터를 수집합니다.
사용법: .ingest into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]
예: .ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)
이 명령은 URL에 나열된 클라우드 스토리지에서 테이블 "custom.myData"로 데이터를 푸시합니다.

.purge table (성능 수준 2 이상으로 제한됨)
데이터베이스의 테이블에서 데이터를 영구적으로 삭제합니다.
사용법: .purge table [TableName] in database [DatabaseName] allrecords with (noregrets='true')
예: .purge table [‘custom.toPurge’] in database MyDatabase allrecords
이 명령은 테이블 "custom.toPurge"에서 모든 데이터를 제거하고 데이터 시스템에서 영구적으로 삭제합니다.