🔧 클라이언트 유틸리티 도구

Client Util App

v1.3.10

개발자와 시스템 관리자를 위한 필수 유틸리티 도구
다국어 지원 (영어/한국어) | UTF-8 CSV 인코딩 지원

다운로드 문서 보기 📦 GitHub
Client Util App
$ client-util --help
Client Util App v1.3.10
Usage: client-util [command] [options]
Commands: db-test, telnet, sql-exec
$ node app.js --lang=kr

주요 기능

개발 및 운영에 필수적인 유틸리티 기능들을 제공합니다

🔗

데이터베이스 연결 및 권한 체크

향상된 로깅과 에러 처리로 더욱 강력해진 데이터베이스 연결 체크

  • 다중 데이터베이스 지원 (MSSQL, MySQL, MariaDB, PostgreSQL, Oracle)
  • 데이터베이스별 구분선으로 향상된 로그 출력
  • SELECT/INSERT/DELETE 작업의 상세 에러 메시지 캡처
  • 통합된 파일 관리와 스마트 필터링
  • 실제 테이블을 사용한 안전한 권한 테스트
🌐

서버 텔넷 체크

원격 서버의 포트 연결 상태를 확인하여 네트워크 문제를 진단합니다.

  • 포트 연결성 테스트
  • 타임아웃 설정
  • 다중 포트 동시 체크
  • 연결 로그 기록
🐛

v1.3.10 CSV-to-DB 개선 사항 (신규)

CSV-to-DB 기능 개선

  • Identity 휴리스틱 제거:
  • MSSQL 계산(Computed) 컬럼 자동 제외
  • 견고한 헤더 매핑:
🛠️

v1.3.9 비대화형 CLI 기능 신규 추가

비대화형 CLI 기능 신규 추가

  • 메뉴 없이 --mode 플래그로 직접 실행 가능
  • 모드: db, telnet, sql, csv, config
  • Node 환경과 배포 EXE 모두 지원
🛠️

v1.3.8 CSV 기반 일괄 쿼리 실행 기능 개선

CSV 기반 일괄 쿼리 실행 관련 명명규칙 및 편의성 개선

  • 파일 명명 규칙 변경: request/의 SQL_ → SQL2CSV_ 접두사
  • 결과 경로 변수: ${DB_NAME}(선택한 DB 키) 지원 추가
  • 메뉴 라벨 및 파일 검색 로직 수정: SQL2CSV_*.csv만 목록에 표시
  • 디렉토리명 통일: request_resources → request
📋

v1.3.7 CSV 쿼리 결과 출력 개선 (신규)

프로시저 정의 등 여러 줄 텍스트의 CSV 포맷 출력 개선

  • 모든 줄바꿈을 공백으로 치환하여 한 줄로 저장
  • CSV 파일일 때만 쉼표/따옴표가 있을 때 따옴표로 감싸기
  • 프로시저 정의가 한 줄로 깔끔하게 저장됨
  • Excel이나 텍스트 편집기에서 읽기 쉬운 형태
  • CSV 표준 준수로 호환성 향상
📊

v1.3.6+ CSV 기반 일괄 쿼리 실행

CSV 파일에서 여러 SQL 쿼리를 일괄 실행하며 보안 기능 제공

  • request/ 폴더의 SQL2CSV_*.csv 파일에서 다중 쿼리 실행
  • 파일 경로에 날짜/시간 변수 지원: ${DATE:yyyyMMddHHmmss}
  • 결과 경로 변수: ${DB_NAME} 지원 (선택한 DB 키)
  • 출력 파일 디렉토리 자동 생성
  • 쿼리 검증: SELECT와 안전한 시스템 프로시저만 허용
  • 차단: INSERT, UPDATE, DELETE, DROP, TRUNCATE, ALTER, CREATE
🌏

v1.3.4 다국어 지원

영어와 한국어 UI를 언어 선택으로 완벽하게 지원

  • --lang 파라미터로 언어 선택 (en/kr)
  • 이중 실행 스크립트: run.bat (영어) / 실행하기.bat (한국어)
  • 60개 이상의 번역된 메시지로 원활한 사용 경험
  • 한글 정상 표시를 위한 UTF-8 CSV 인코딩 필수
  • package.json에서 버전 자동 읽기
⚡

데이터베이스 SQL 실행

파라미터화된 SQL 쿼리를 여러 조건으로 실행하고 CSV 결과 저장

  • CSV/JSON 파라미터 파일로 다중 조건 실행
  • #DATABASE 지시자로 접속 DB 자동 선택
  • 구조화된 CSV 결과 파일 생성
  • 조건별 결과 명확히 구분
  • 실행 시간 및 메타데이터 자동 기록

기술 사양

Client Util App의 상세한 기술 정보

개발 환경

언어 Node.js
런타임 v16.0+
패키지 매니저 npm/yarn
CLI 프레임워크 Commander.js

데이터베이스

지원 DB MSSQL, MySQL, MariaDB, PostgreSQL, Oracle
권한 체크 SELECT, INSERT, DELETE
에러 캡처 최대 500자
로그 출력 DB별 구분선

네트워크

프로토콜 TCP/IP
타임아웃 설정 가능
재시도 자동
로깅 파일/콘솔

성능

메모리 사용량 ~50MB
응답 시간 <1초
동시 연결 10개
플랫폼 Cross-platform

사용 예제

Client Util App의 다양한 사용 방법을 확인해보세요

Windows Batch 
# 실행 스크립트를 더블클릭하거나 명령 프롬프트에서 실행
# 영어 UI:
run.bat

# 한국어 UI:
실행하기.bat

# 또는 직접 언어 지정:
node app.js --lang=en
node app.js --lang=kr

# 실행 후 메뉴 선택:
========================================
    Node.js 통합 유틸리티 도구
========================================

📋 메인 메뉴
1. 데이터베이스 연결 및 권한 체크
2. 서버 텔넷 연결 체크  
3. 데이터베이스 SQL 실행
4. 설정 관리
5. 모든 체크 실행 (일괄 처리)
6. 종료

실행할 기능을 선택하세요 (1-6): 1

# CSV 파일 선택:
📁 사용 가능한 CSV 파일:
  1. DB_sample.csv
  2. server_sample.csv

사용할 CSV 파일 선택 (1-2): 1

# 자동으로 실행되며 결과가 results/ 폴더에 저장됩니다
CLI 
# 기본 연결 테스트
client-util db-test --server localhost --database master

# 상세 옵션과 함께
client-util db-test \
  --server 192.168.1.100 \
  --port 1433 \
  --database MyDatabase \
  --username sa \
  --timeout 30

# 연결 문자열 사용
client-util db-test \
  --connection-string "Server=localhost;Database=master;Trusted_Connection=true;"
CLI 
# 단일 포트 체크
client-util telnet --host localhost --port 1433

# 다중 포트 체크
client-util telnet \
  --host 192.168.1.100 \
  --ports 80,443,1433,3306 \
  --timeout 5000

# 결과를 파일로 저장
client-util telnet \
  --host example.com \
  --port 80 \
  --output telnet-result.log
CLI 
# 직접 쿼리 실행
client-util sql-exec \
  --server localhost \
  --database MyDatabase \
  --query "SELECT TOP 10 * FROM Users"

# 파일에서 쿼리 실행
client-util sql-exec \
  --server localhost \
  --database MyDatabase \
  --file queries.sql

# 결과를 CSV로 출력
client-util sql-exec \
  --server localhost \
  --database MyDatabase \
  --query "SELECT * FROM Products" \
  --format csv \
  --output products.csv

문서

Client Util App 사용을 위한 상세한 문서

📖

사용자 매뉴얼

Client Util App 설치 및 기본 사용법을 알아보세요.

매뉴얼 보기 GitHub 매뉴얼
📋

변경이력

버전 히스토리와 기능 업데이트 - 최신: v1.3.10

  • v1.3.10: 비대화형 CLI 오류/종료코드 개선, CSV 일괄 실행 경로/로그 개선, 소규모 수정
  • v1.3.9: --mode 기반 비대화형 CLI 추가 (db/telnet/sql/csv/config), 매뉴얼 업데이트
  • v1.3.8: SQL2CSV 접두사로 변경, ${DB_NAME} 변수 지원, 메시지 리팩터링
  • v1.3.4: 다국어 지원 (영어/한국어), UTF-8 CSV 인코딩, 이중 실행 스크립트
  • v1.3.3: 배포판 경로 해석 버그 수정
  • v1.3.0: SQL Executor 개선, CSV 결과 파일, MariaDB 지원, JSON 파라미터
  • v1.2.0: 향상된 로깅, 상세 에러 캡처, 간소화된 파일 관리
  • v1.1.0: 안전한 권한 체크, 실제 테이블 테스트
  • v1.0.0: 핵심 기능과 함께 초기 릴리스
전체 변경이력 보기

문의하기

Client Util App에 대한 문의사항이 있으시면 언제든 연락주세요

연락처 정보

✉️
이메일
happysoftinfodesk@gmail.com
🌐
웹사이트
happysoft2018.com