Skip to contents

이 함수는 KOSIS 데이터 설명 정보를 HTML 테이블 형식으로 생성합니다.

Usage

tab_kosis_desc(tbl_id = NULL, org_id = NULL)

Arguments

tbl_id

character. 데이터 테이블 ID.

org_id

character. 제공기관 ID. 기본값은 NULL.

Value

data.frame. KOSIS 데이터 설명 정보를 포함하는 데이터 프레임.

Examples

# \donttest{
# Example usage
tbl_id <- "DT_1YL21171"
org_id <- "101"

tab_kosis_desc(tbl_id = tbl_id, org_id = org_id)
#>            [,1]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           
#> 데이터명   "교원 1인당 학생수(시도/시/군/구)"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             
#> 수록기간   "년 2007~2025"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 
#> 출처       "한국교육개발원 02-2012-9114\r\n / 043-530-9620"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               
#> 분류및항목 "<b>행정구역별 (256개)</b><br>전국, 서울특별시, 종로구, 중구, 용산구<br>성동구, 광진구, 동대문구, 중랑구, 성북구, ...<br><b>항목 (3개)</b><br>교원1인당 학생수 (A÷B)<br>재적학생수 (A)<br>교원수 (B)"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          
#> 제공처     "국가데이터처 통계정책과"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      
#> 주석       "■ <b>자료제공처:</b> 국가데이터처 지역통계기획팀<br>■ <b>자료원출처:</b> 한국교육개발원(교육기본통계)<br>■ <b>자료제공주기:</b> 1년<br>■ <b>다음자료현행화:</b> 작성기준년도 8월<br><br><br>□ <b>정의</b><br>  - 교원1인당 학생수: 1명의 교원이 담당하는 학생의 수<br><br>□ <b>의의</b><br>  - 교육여건의 수준을 판단할 수 있는 대표적인 지표로 교원1인당 학생수가 적을수록 교사와 학생 간의 긴밀한 상호작용이 가능하고 이를 통해 교육이 내실 있게 이루어질 가능성이 높아짐. 따라서 교원1인당 학생수 수치가 낮을수록 교육여건이 상대적으로 좋다는 평가를 내릴 수 있음<br><br>□ <b>산식</b><br>  - 교원1인당 학생수=재적학생수÷총교원수<br><br>□ <b>용어</b><br> - 학생수: 유치원, 초등, 중등, 고등, 대학교 학생생수의 합<br> - 교원수: 유치원, 초등, 중등, 고등, 대학교 교원수의 합<br> - 대학교: 일반대, 전문대, 교육대, 산업대<br> <br>□ <b>참고사항</b><br>  - 당해 4월1일 조사기준일 자료<br>  - 대학교 교원수: 2012년까지는 총(학)장 및 교수, 부교수, 조교수, 전임강사로 조사되었으며, 2013년부터 전임강사 폐지에 따라 총(학)장 및 교수, 부교수, 조교수로 조사됨<br><br><br><br>- <b>시도>세종특별자치시:</b> 2012.7.1.부로 연기군 전체와 공주시, 청원군 일부를 통합하여 출범<br>- <b>시>경남 창원시:</b> 2010.7.1.부로 창원시, 마산시, 진해시가 창원시로 통합<br>- <b>시>충남 당진시:</b> 2012.1.1.부로 당진군이 당진시로 승격<br>- <b>시>경기 여주시:</b> 2013.9.23.부로 여주군이 여주시로 승격<br>- <b>시>충북 청주시:</b> 2014.7.1.부로 청주시와 청원군이 통합<br>- <b>구>인천 미추홀구:</b> 2018.7.1.부로 남구가 미추홀구로 명칭변경<br>- <b>군>대구 군위군: </b> 2023.7.1.부로 경북 군위군이 대구 군위군으로 편입 "
#> 갱신일자   "2025-10-28"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   

# HTML 테이블 스타일 적용 예시
tab_kosis_desc(tbl_id = 'DT_1YL21171', org_id = '101') |>
  htmlTable::addHtmlTableStyle(
    align = "ll",
    col.rgroup = c("none", "#F7F7F7"),
    css.cell = c("width: 100px;", "width: 600px;") ) |>
  htmlTable::htmlTable(css.table = "font-size: 12px;")
#> <table class='gmisc_table' style='border-collapse: collapse; font-size: 12px;' >
#> <tbody>
#> <tr style='border-top: 2px solid grey;'>
#> <td style='width: 100px; border-top: 2px solid grey; text-align: left;'>데이터명</td>
#> <td style='width: 600px; border-top: 2px solid grey; text-align: left;'>교원 1인당 학생수(시도/시/군/구)</td>
#> </tr>
#> <tr style='background-color: #f7f7f7;'>
#> <td style='width: 100px; background-color: #f7f7f7; text-align: left;'>수록기간</td>
#> <td style='width: 600px; background-color: #f7f7f7; text-align: left;'>년 2007~2025</td>
#> </tr>
#> <tr>
#> <td style='width: 100px; text-align: left;'>출처</td>
#> <td style='width: 600px; text-align: left;'>한국교육개발원 02-2012-9114

#>  / 043-530-9620</td>
#> </tr>
#> <tr style='background-color: #f7f7f7;'>
#> <td style='width: 100px; background-color: #f7f7f7; text-align: left;'>분류및항목</td>
#> <td style='width: 600px; background-color: #f7f7f7; text-align: left;'><b>행정구역별 (256개)</b><br>전국, 서울특별시, 종로구, 중구, 용산구<br>성동구, 광진구, 동대문구, 중랑구, 성북구, ...<br><b>항목 (3개)</b><br>교원1인당 학생수 (A÷B)<br>재적학생수 (A)<br>교원수 (B)</td>
#> </tr>
#> <tr>
#> <td style='width: 100px; text-align: left;'>제공처</td>
#> <td style='width: 600px; text-align: left;'>국가데이터처 통계정책과</td>
#> </tr>
#> <tr style='background-color: #f7f7f7;'>
#> <td style='width: 100px; background-color: #f7f7f7; text-align: left;'>주석</td>
#> <td style='width: 600px; background-color: #f7f7f7; text-align: left;'>■ <b>자료제공처:</b> 국가데이터처 지역통계기획팀<br>■ <b>자료원출처:</b> 한국교육개발원(교육기본통계)<br>■ <b>자료제공주기:</b> 1년<br>■ <b>다음자료현행화:</b> 작성기준년도 8월<br><br><br>□ <b>정의</b><br>  - 교원1인당 학생수: 1명의 교원이 담당하는 학생의 수<br><br>□ <b>의의</b><br>  - 교육여건의 수준을 판단할 수 있는 대표적인 지표로 교원1인당 학생수가 적을수록 교사와 학생 간의 긴밀한 상호작용이 가능하고 이를 통해 교육이 내실 있게 이루어질 가능성이 높아짐. 따라서 교원1인당 학생수 수치가 낮을수록 교육여건이 상대적으로 좋다는 평가를 내릴 수 있음<br><br>□ <b>산식</b><br>  - 교원1인당 학생수=재적학생수÷총교원수<br><br>□ <b>용어</b><br> - 학생수: 유치원, 초등, 중등, 고등, 대학교 학생생수의 합<br> - 교원수: 유치원, 초등, 중등, 고등, 대학교 교원수의 합<br> - 대학교: 일반대, 전문대, 교육대, 산업대<br> <br>□ <b>참고사항</b><br>  - 당해 4월1일 조사기준일 자료<br>  - 대학교 교원수: 2012년까지는 총(학)장 및 교수, 부교수, 조교수, 전임강사로 조사되었으며, 2013년부터 전임강사 폐지에 따라 총(학)장 및 교수, 부교수, 조교수로 조사됨<br><br><br><br>- <b>시도>세종특별자치시:</b> 2012.7.1.부로 연기군 전체와 공주시, 청원군 일부를 통합하여 출범<br>- <b>시>경남 창원시:</b> 2010.7.1.부로 창원시, 마산시, 진해시가 창원시로 통합<br>- <b>시>충남 당진시:</b> 2012.1.1.부로 당진군이 당진시로 승격<br>- <b>시>경기 여주시:</b> 2013.9.23.부로 여주군이 여주시로 승격<br>- <b>시>충북 청주시:</b> 2014.7.1.부로 청주시와 청원군이 통합<br>- <b>구>인천 미추홀구:</b> 2018.7.1.부로 남구가 미추홀구로 명칭변경<br>- <b>군>대구 군위군: </b> 2023.7.1.부로 경북 군위군이 대구 군위군으로 편입 </td>
#> </tr>
#> <tr>
#> <td style='width: 100px; border-bottom: 2px solid grey; text-align: left;'>갱신일자</td>
#> <td style='width: 600px; border-bottom: 2px solid grey; text-align: left;'>2025-10-28</td>
#> </tr>
#> </tbody>
#> </table>
# }