본문 바로가기
Project/TeamFightTactics

[데이터 저장] 데이터 정의서

by Wikinist 2023. 8. 7.

[데이터 명세]

[TFT 최상위 플레이어 매치 데이터]

1. 데이터 정의

TFT 매치의 최종 결과 데이터이며, 국가별 Top10의 플레이어들의 최근 10경기 정보입니다.

2. 수집 방법

Riot API 에서 제공하는 TFT-MATCH-V1을 이용합니다.

3. 수집 경로

Riot Developer Portal(https://developer.riotgames.com/apis#tft-match-v1/)

4. 데이터의 논리적 구조

데이터의 논리적 구조를 이해하기 위해 아래의 이미지를 참고할 수 있습니다.

TFT 매치 라운드 대기시간
TFT 증강 선택 라운드

4.1 Matches

이름 설명
match_id 매치 아이디입니다.
match_date 매치가 시작한 날짜 정보입니다.(datetime)
match_length 매치 길이입니다.(단위: 초)
version_major 메이저 버전입니다.
version_minor 마이너 버전입니다.
version_patch 패치 버전입니다.
version_date 버전 날짜 정보입니다.(datetime)
tft_set_number TFT set 번호입니다.

4.2 MatchPlayers

이름 설명
match_player_id 매치 플레이어 아이디입니다.
match_id 매치 아이디입니다.
puuid Player Universally Unique IDentifiers입니다.
last_round 플레이어가 탈락한 라운드. 주의: 플레이어가 스테이지 2-1에서 탈락한 경우 last_round는 5입니다.
level 플레이어 꼬마 전설이 레벨. 주의: 이것은 활성 유닛의 수가 아닙니다.
placement 플레이어의 최종 순위입니다.
time_eliminated 플레이어가 제거되기까지의 시간(초)입니다.

4.3 MatchAugments

이름 설명
match_player_id 매치 플레이어 아이디입니다.
name 증강체 이름입니다.
sequence 증강체의 순서 정보입니다.

4.4 MatchTraits

이름 설명
match_player_id 매치 플레이어 아이디입니다.
name 특성 이름입니다.
num_units 현재 필드에 적용된 유닛의 수 입니다.
style 이 특성의 현재 스타일입니다. (0 = 스타일 없음, 1 = 브론즈, 2 = 실버, 3 = 골드, 4 = 크로매틱)
tier_current 특성의 현재 활성 단계입니다.
tier_total 특성의 전체 총 단계 정보입니다.
sequence 특성의 순서 정보입니다.

4.5 MatchUnits

이름 설명
match_player_id 매치 플레이어 아이디입니다.
name 유닛 이름입니다.
rarity 유닛 희귀도. 이것은 단위 비용과 동일하지 않습니다.
tier 유닛의 단계입니다.
sequence 유닛의 순서 정보입니다.
item1 유닛의 아이템 입니다. 아이템 ID는 Teamfight Tactics 문서를 참조하세요.
item2 유닛의 아이템 입니다. 아이템 ID는 Teamfight Tactics 문서를 참조하세요.
item3 유닛의 아이템 입니다. 아이템 ID는 Teamfight Tactics 문서를 참조하세요.

5. 데이터의 물리적 저장 구조

DB Table
TFTDB  
  match
  match_player
  match_augment
  match_trait
  match_unit

[국가별 최상위 플레이어 리스트 데이터]

1. 데이터 정의

각 국가별 최상위 플레이어(Top10)의 데이터입니다.

2. 수집 방법

  • Riot API를 통해 첼린저 리그의 플레이어 리스트를 가져옵니다.
  • 유저 이름을 바탕으로 Riot API에서 puuid를 추출합니다.

3. 수집 경로

4. 데이터의 논리적 구조

4.1 Players

이름 설명
puuid Player Universally Unique IDentifiers입니다.
name 유저 이름입니다.
continent 대륙 정보입니다.
region 지역 정보입니다.

4.2 PlayerStatistics

이름 설명
puuid Player Universally Unique IDentifiers입니다.
ranking 현재 해당 서버에서의 순위입니다.
league_point 현재 리그의 점수입니다.
wins 4등 이하 기록의 수입니다.
losses 5등 이상 기록의 수입니다.
update_date 업데이트 된 날짜입니다.(datetime)

5. 데이터의 물리적 저장 구조

DB Table
TFTDB  
  player
  player_statistic