---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# TableUtils - 전역

# TableUtils - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 13분

TableUtils 스크립트 포함은 테이블 관련 정보에 액세스할 수 있는 바로 가기를 제공합니다.

이 클래스는 서버 측 스크립트에서 사용할 수 있습니다.

## TableUtils - TableUtils(문자열 tableName) {#ariaid-title2}

TableUtils 클래스의 인스턴스를 만듭니다.
{#r_TU-TableUtils_S__table_jm5_34v_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 테이블 이름 |
[표 1. 매개변수]

{#r_TU-TableUtils_S__table_jm5_34v_4t}  

    var tu = new TableUtils("incident");

## TableUtils - drop(문자열 tableName) {#ariaid-title3}

데이터베이스 테이블을 삭제합니다.
주:  
각별히 주의하여 사용하십시오. 테이블을 삭제하면 테이블과 모든 데이터가 영구적으로 삭제됩니다. 테이블이 확장된 경우 dropTableAndExtensions를 사용합니다.
{#r_TU-drop_S__table_ojq_gpv_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 삭제할 테이블의 이름 |
[표 2. 매개변수]

{#r_TU-drop_S__table_ojq_gpv_4t} {#r_TU-drop_S__table_pjq_gpv_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 3. 반환]

{#r_TU-drop_S__table_pjq_gpv_4t}  

    var tu = new TableUtils();
    tu.drop("table_that_will_be_lost_forever");

출력:

    dropping table table_that_will_be_lost_forever
    Starting cache flush
    Cache flush complete
    TABLE DROP: admin dropped table table_that_will_be_lost_forever

## TableUtils - dropAndClean(문자열 tableName) {#ariaid-title4}

데이터베이스 테이블을 삭제하고 테이블에 대한 참조를 정리합니다.
주:  
각별히 주의하여 사용하십시오. 데이터베이스 테이블을 삭제하면 테이블과 모든 데이터가 영구적으로 삭제됩니다. 테이블이 확장된 경우 dropTableAndExtensions를 사용합니다.
{#r_TU-dropAndClean_S__table_mb5_15v_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 삭제할 테이블의 이름 |
[표 4. 매개변수]

{#r_TU-dropAndClean_S__table_mb5_15v_4t} {#r_TU-dropAndClean_S__table_nb5_15v_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 5. 반환]

{#r_TU-dropAndClean_S__table_nb5_15v_4t}  

    var tu = new TableUtils();
    tu.dropAndClean("table_that_will_be_lost_forever");

출력:

    dropping table table_that_will_be_lost_forever
    Starting cache flush
    Cache flush complete
    TABLE DROP: admin dropped table table_that_will_be_lost_forever
    *** Script: removing gauges for table_that_will_be_lost_forever
    *** Script: removing forms for table_that_will_be_lost_forever
    *** Script: removing styles for table_that_will_be_lost_forever
    *** Script: removing forms sections for table_that_will_be_lost_forever
    *** Script: removing lists for table_that_will_be_lost_forever
    *** Script: removing related lists for table_that_will_be_lost_forever
    *** Script: removing references to table_that_will_be_lost_forever
    *** Script: removing dictionary entries for table_that_will_be_lost_forever
    Background message, type:info, message: Table deleted

## TableUtils - dropTableAndExtensions(문자열 tableName) {#ariaid-title5}

데이터베이스 테이블과 모든 확장 테이블을 삭제하고 테이블에 대한 참조를 정리합니다.
주:  
각별히 주의하여 사용하십시오. 데이터베이스 테이블을 삭제하면 테이블과 모든 데이터가 영구적으로 삭제됩니다.
{#r_TU-dropTableAndExtensions_S__table_yhf_r5v_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 삭제할 테이블 |
[표 6. 매개변수]

{#r_TU-dropTableAndExtensions_S__table_yhf_r5v_4t} {#r_TU-dropTableAndExtensions_S__table_zhf_r5v_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 7. 반환]

{#r_TU-dropTableAndExtensions_S__table_zhf_r5v_4t}  

    var tu = new TableUtils();
    tu.dropTableAndExtensions("table_that_will_be_lost_forever");

출력:

    dropping table parent_table_that_will_be_lost_forever
    Starting cache flush
    Cache flush complete
    TABLE DROP: admin dropped table ext_table_that_will_be_lost_forever
    removing gauges for ext_table_that_will_be_lost_forever
    removing forms for ext_table_that_will_be_lost_forever
    removing styles for ext_table_that_will_be_lost_forever
    removing forms sections for ext_table_that_will_be_lost_forever
    removing lists for ext_table_that_will_be_lost_forever
    removing related lists for ext_table_that_will_be_lost_forever
    removing references to ext_table_that_will_be_lost_forever
    removing dictionary entries for ext_table_that_will_be_lost_forever
    Background message, type:info, message: Table deleted
    dropping table parent_table_that_will_be_lost_forever
    Starting cache flush
    Cache flush complete
    TABLE DROP: admin dropped table parent_table_that_will_be_lost_forever
    removing gauges for parent_table_that_will_be_lost_forever
    removing forms for parent_table_that_will_be_lost_forever
    removing styles for parent_table_that_will_be_lost_forever
    removing forms sections for parent_table_that_will_be_lost_forever
    removing lists for parent_table_that_will_be_lost_forever
    removing related lists for parent_table_that_will_be_lost_forever
    removing references to parent_table_that_will_be_lost_forever
    removing dictionary entries for parent_table_that_will_be_lost_forever
    Background message, type:info, message: Table deleted

## TableUtils - getAbsoluteBase() {#ariaid-title6}

테이블이 확장된 기본 테이블 이름을 반환합니다.
주:  
cmdb_ci 계층 구조 아래의 모든 테이블에 대해 이 메서드는 실제 기본 테이블인 cmdb가 아닌 cmdb_ci를 반환합니다.
{#r_TU-getAbsoluteBase__table_c3f_gyv_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 8. 매개변수]

{#r_TU-getAbsoluteBase__table_c3f_gyv_4t} {#r_TU-getAbsoluteBase__table_d3f_gyv_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 기본 테이블 이름 |
[표 9. 반환]

{#r_TU-getAbsoluteBase__table_d3f_gyv_4t}  

    var table = new TableUtils("cmdb_ci_server");
    gs.print(table.getAbsoluteBase());

출력: cmdb_ci

## TableUtils - getAllExtensions() {#ariaid-title7}

기본 테이블을 포함하여 테이블을 확장하는 테이블 목록을 반환합니다.
{#r_TU-getAllExtensions__table_yq3_gxv_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 10. 매개변수]

{#r_TU-getAllExtensions__table_yq3_gxv_4t} {#r_TU-getAllExtensions__table_zq3_gxv_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 목록 | 기본 테이블을 포함하여 테이블을 확장하는 테이블 목록입니다. |
[표 11. 반환]

{#r_TU-getAllExtensions__table_zq3_gxv_4t}  

    var table = new TableUtils("task");
    gs.print(table.getAllExtensions());

출력:

    [task, incident, issue, kb_submission, sysapproval_group, change_request, change_request_imac, sc_task, 
    problem, sc_req_item, ticket, ast_transfer_order, planned_task, change_task, change_phase, sc_request]

## TableUtils - getHierarchy() {#ariaid-title8}

지정된 테이블의 계층 구조에 참여하는 모든 클래스의 목록을 반환합니다.
{#r_TU-getHierarchy__table_lbl_ryv_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 12. 매개변수]

{#r_TU-getHierarchy__table_lbl_ryv_4t} {#r_TU-getHierarchy__table_mbl_ryv_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 목록 | 지정된 테이블의 계층 구조에 있는 모든 클래스의 목록입니다. |
[표 13. 반환]

{#r_TU-getHierarchy__table_mbl_ryv_4t}  

    var table = new TableUtils("cmdb_ci_server");
    gs.print(table.getHierarchy());

출력: \[cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci, cmdb_ci_mainframe, cmdb_ci_linux_server, cmdb_ci_mainframe_lpar, cmdb_ci_esx_server, cmdb_ci_unix_server, cmdb_ci_solaris_server, cmdb_ci_hpux_server, cmdb_ci_aix_server, cmdb_ci_osx_server, cmdb_ci_netware_server, cmdb_ci_win_server\]

## TableUtils - getTables() {#ariaid-title9}

테이블 계층 구조를 반환합니다.
{#r_TU-getTables__table_z1t_3wv_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 14. 매개변수]

{#r_TU-getTables__table_z1t_3wv_4t} {#r_TU-getTables__table_abt_3wv_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 목록 | 상위 계층 구조의 테이블 이름 목록입니다. |
[표 15. 반환]

{#r_TU-getTables__table_abt_3wv_4t}  

    // Get the hierarchy of tables
    var table = new TableUtils("cmdb_ci_computer");
    var tableArrayList = table.getTables();

    // Use the j2js method to convert the Java ArrayList to JavaScript
    gs.include("j2js");
    var tableArray = j2js(tableArrayList);

    // Write the value of each element in the JavaScript array
    var i = 0;
    while ( i < tableArray.length ) {
    gs.print("Table with index " + i + ": " + tableArray[i]);
    i++;
    }

출력:

    Table with index 0: cmdb_ci_computer
    Table with index 1: cmdb_ci_hardware
    Table with index 2: cmdb_ci
    Table with index 3: cmdb

## TableUtils - getTableExtensions() {#ariaid-title10}

테이블을 확장하는 테이블 목록을 반환합니다.
{#r_TU-getTableExtensions__table_sfl_twv_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 16. 매개변수]

{#r_TU-getTableExtensions__table_sfl_twv_4t} {#r_TU-getTableExtensions__table_tfl_twv_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 목록 | 테이블을 확장하는 테이블 이름의 목록입니다. |
[표 17. 반환]

{#r_TU-getTableExtensions__table_tfl_twv_4t}  
이 예에서는 이 인스턴스의 58개 테이블이 컴퓨터 \[cmdb_ci_computer\] 테이블을 확장함을 보여줍니다. (출력은 아래에 요약되어 있습니다.)

    // Get the tables that extend the table
    var table = new TableUtils("cmdb_ci_computer");
    var tableArrayList = table.getTableExtensions();
     
    // Use the j2js method to convert the Java ArrayList to JavaScript
    gs.include("j2js");
    var tableArray = j2js(tableArrayList);
     
    // Write the value of each element in the JavaScript array
    var i = 0;
    while ( i < tableArray.length ) {
      gs.print("Table with index " + i + ": " + tableArray[i]);
      i++;
    }

출력:

    Table with index 0: cmdb_ci_mainframe_hardware
    Table with index 1: cmdb_ci_handheld_computing
    Table with index 2: cmdb_ci_ucs_blade
    Table with index 3: cmdb_ci_storage_switch
    Table with index 4: cmdb_ci_server
    Table with index 5: cmdb_ci_hmc_server
    ...
    Table with index 56: cmdb_ci_pc_hardware
    Table with index 57: cmdb_ci_ucs_rack_unit

## TableUtils - hasExtensions() {#ariaid-title11}

테이블이 확장되었는지 여부를 결정합니다.
{#r_TU-hasExtensions__table_lby_m1w_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 18. 매개변수]

{#r_TU-hasExtensions__table_lby_m1w_4t} {#r_TU-hasExtensions__table_mby_m1w_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 테이블에 확장이 있는 경우 True입니다. |
[표 19. 반환]

{#r_TU-hasExtensions__table_mby_m1w_4t}  

    var table = new TableUtils("cmdb_ci_server");
    gs.print(table.hasExtensions());

출력:

    true

## TableUtils - isBaseClass() {#ariaid-title12}

테이블이 기본 클래스인지, 즉 상위 테이블이 없고 확장이 있는지 여부를 결정합니다.
예를 들어 작업은 다른 테이블에서 확장되지 않고 테이블이 확장되었기 때문에 기본 클래스입니다. Sys_user는 부모가 없기 때문에 기본 클래스가 아니지만 확장명은 없습니다.
{#r_TU-isBaseClass__table_k5p_w1w_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 20. 매개변수]

{#r_TU-isBaseClass__table_k5p_w1w_4t} {#r_TU-isBaseClass__table_l5p_w1w_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 테이블이 기본 클래스 테이블인지 여부를 나타내는 플래그로, 상위 테이블은 없지만 확장은 있습니다. 유효한 값은 다음과 같습니다. * true: 테이블이 기본 클래스입니다. * false: 테이블이 기본 클래스가 아닙니다. {#r_TU-isBaseClass__ul_wp1_hjt_43b} |
[표 21. 반환]

{#r_TU-isBaseClass__table_l5p_w1w_4t}  

    var table = new TableUtils("task");
    gs.print("Task is base class: " + table.isBaseClass());
     
    var table = new TableUtils("sys_user");
    gs.print("User is base class: " + table.isBaseClass());

출력:

     Task is base class: true
    User is base class: false

## TableUtils - isSoloClass() {#ariaid-title13}

테이블에 상위 항목과 확장이 없는지 여부를 결정합니다.
{#r_TU-isSoloClass__table_lv2_nbw_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 22. 매개변수]

{#r_TU-isSoloClass__table_lv2_nbw_4t} {#r_TU-isSoloClass__table_mv2_nbw_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 테이블에 상위 테이블이 없고 상위 테이블에서 확장되지 않는 경우 True입니다. |
[표 23. 반환]

{#r_TU-isSoloClass__table_mv2_nbw_4t}  

    var table = new TableUtils("task");
    gs.print("task is solo class: " + table.isSoloClass());
     
    var table = new TableUtils("cmdb_ci_win_server");
    gs.print("cmdb_ci_win_server is solo class: " + table.isSoloClass());
     
    var table = new TableUtils("sys_user");
    gs.print("sys_user is solo class: " + table.isSoloClass());

출력:

    task is solo class: false
    cmdb_ci_win_server is solo class: false
    sys_user is solo class: true

## TableUtils - tableExists() {#ariaid-title14}

테이블이 있는지 확인합니다.
{#r_TU-tableExists__table_txx_x4v_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 24. 매개변수]

{#r_TU-tableExists__table_txx_x4v_4t} {#r_TU-tableExists__table_uxx_x4v_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 테이블이 존재하는 경우 True입니다. |
[표 25. 반환]

{#r_TU-tableExists__table_uxx_x4v_4t}  

    var table = new TableUtils("my_table");
    gs.print("Does 'my_table' exist? " + table.tableExists());

출력: "my_table"이 있습니까? 거짓