데이터소스 목록
개요
이 화면은 무엇인가요?
공장의 센서, PLC, SCADA 등 외부 데이터소스를 시스템에 등록하고, 연결 상태를 실시간으로 확인하는 화면입니다. OPC-UA, MQTT, Modbus, REST API 등 다양한 산업 프로토콜을 지원합니다.
누가 사용하나요?
- IoT 엔지니어: 데이터소스 등록, 프로토콜 설정, 연결 테스트
- 시스템 관리자: 연결 상태 모니터링, 장애 대응
언제 사용하나요?
- 신규 설비/센서를 설치하고 데이터 연결을 설정할 때
- 데이터소스의 연결 상태를 점검하거나 장애를 확인할 때
- 기존 데이터소스의 인증 정보나 연결 설정을 변경할 때
주요 기능
- 데이터소스 등록: OPC-UA, MQTT, Modbus, PLC, REST API 등 프로토콜별 연결 설정
- 연결 상태 확인: 실시간 연결 상태(연결됨/끊김/오류) 모니터링
- 인증 관리: Basic, Certificate, Token 등 인증 유형 설정 (AES-256 암호화 저장)
- CSV 가져오기/내보내기: 대량 데이터소스 일괄 등록·백업
업무 흐름에서의 위치
입력 항목 가이드
기본정보
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 소스코드 | 데이터소스를 식별하는 고유 코드 | ✅ | OPC-FACTORY1-01 |
| 소스명 | 사용자가 식별하기 쉬운 이름 | ✅ | 1공장 OPC-UA 서버 |
| 소스유형 | 통신 프로토콜 유형 선택 | ✅ | OPC-UA / MQTT / MODBUS / PLC 등 |
| 프로토콜 | 프로토콜 상세 정보 | opc.tcp:// | |
| 사용여부 | 데이터소스 활성화 상태 | 기본값: 활성 | |
| 담당자 | 데이터소스 관리 담당자 | 사용자 선택 |
연결설정
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 호스트 | 데이터소스 서버의 IP 또는 도메인 | 192.168.1.100 | |
| 포트 | 연결 포트 번호 | 4840 (OPC-UA 기본) | |
| 인증유형 | 인증 방식 선택 | none / basic / certificate / token | |
| TLS사용 | SSL/TLS 암호화 사용 여부 | 보안 환경에서는 활성화 권장 | |
| 연결타임아웃(ms) | 연결 대기 최대 시간 | 5000 (5초) | |
| 재시도횟수 | 연결 실패 시 재시도 횟수 | 3 | |
| 재시도간격(ms) | 재시도 간 대기 시간 | 10000 (10초) |
상태 (자동 표시)
| 항목 | 설명 |
|---|---|
| 연결상태 | 현재 연결 상태 — connected(연결됨) / disconnected(끊김) / error(오류) / unknown(미확인) |
| 최종연결시각 | 마지막으로 연결이 성공한 시각 |
목록 화면 설정
표시 컬럼
| 컬럼 | 표시 형태 | 정렬 |
|---|---|---|
| 소스코드 | 링크 (클릭 시 상세 이동) | ✅ |
| 소스명 | 텍스트 | ✅ |
| 소스유형 | 태그 (컬러 구분) | ✅ |
| 호스트 | 텍스트 | ✅ |
| 포트 | 텍스트 | ✅ |
| 연결상태 | 배지 (녹색/빨간색/노란색) | ✅ |
| 사용여부 | 텍스트 | ✅ |
| 최종연결시각 | 날짜 | ✅ |
검색/필터
| 필드 | 필터 유형 | 설명 |
|---|---|---|
| 소스코드 | 텍스트 검색 | 코드로 빠르게 찾기 |
| 소스유형 | 드롭다운 선택 | OPC-UA, MQTT 등 유형별 필터 |
| 연결상태 | 드롭다운 선택 | 연결됨/끊김/오류 상태별 필터 |
자주 묻는 질문 (FAQ)
연결 상태가 계속 'error'로 표시됩니다. 어떻게 해야 하나요?
- 호스트/포트 확인: 대상 서버의 IP와 포트가 정확한지 확인합니다
- 네트워크 확인: 방화벽에서 해당 포트가 열려 있는지 확인합니다
- 인증 정보 확인: 인증 유형에 맞는 자격 증명이 올바른지 확인합니다
- 타임아웃 조정: 네트워크 지연이 있는 환경이라면 연결타임아웃을 늘려봅니다
- TLS 설정 확인: TLS 사용 시 인증서 경로와 유효성을 점검합니다
데이터소스를 대량으로 등록하려면?
CSV 가져오기 기능을 사용합니다:
- 기존 데이터소스를 CSV로 내보내어 템플릿을 확보합니다
- 템플릿에 맞춰 신규 데이터소스 정보를 입력합니다
- CSV 가져오기로 일괄 등록합니다
주의: 인증 정보(credentials)는 보안상 CSV에 포함되지 않으므로 개별 설정이 필요합니다.
실무 시나리오
OPC-UA 서버 연결 설정
상황: 1공장의 Siemens PLC에 OPC-UA 서버가 설치되어 있고, 이를 디지털 트윈 시스템에 연결해야 합니다.
처리 순서:
- 소스코드
OPC-S7-FACTORY1으로 신규 데이터소스를 생성합니다 - 소스유형을
OPC-UA로 선택합니다 - 호스트에
192.168.10.50, 포트에4840을 입력합니다 - 인증유형을
certificate로 설정하고 인증서를 등록합니다 - TLS사용을 활성화하고 연결 테스트를 수행합니다
- 연결상태가
connected로 표시되면 설비자산 계층 화면에서 설비를 연결합니다
참고: 데이터 구조
데이터소스 테이블 (data_sources)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
source_code | 소스코드 | VARCHAR *필수 *고유 | - |
source_name | 소스명 | VARCHAR *필수 | - |
source_type | 소스유형 | ENUM(OPC-UA, MODBUS, MQTT, REST-API, DATABASE, PLC, SPARKPLUG-B) *필수 | - |
protocol | 프로토콜 | VARCHAR | 통신 프로토콜 상세 |
host | 호스트 | VARCHAR | IP 또는 도메인 |
port | 포트 | INT | 연결 포트 번호 |
auth_type | 인증유형 | ENUM(none, basic, certificate, token) | - |
connection_config | 연결설정 | TEXT | JSON 형태의 연결 상세 설정 |
is_active | 사용여부 | BOOLEAN | - |
connection_status | 연결상태 | ENUM(connected, disconnected, error, unknown) | 현재 연결 상태 |
last_connected_at | 최종연결시각 | TIMESTAMP | 마지막 연결 성공 시각 |
connection_timeout_ms | 연결타임아웃(ms) | INT | 연결 타임아웃 (밀리초) |
retry_count | 재시도횟수 | INT | 연결 실패 시 재시도 횟수 |
retry_interval_ms | 재시도간격(ms) | INT | 재시도 간격 (밀리초) |
use_tls | TLS사용 | BOOLEAN | TLS/SSL 암호화 사용 여부 |
tls_config | TLS설정 | JSONB | 인증서 경로 등 — 암호화 저장(AES-256) |
credentials | 인증정보 | JSONB | 인증 자격 증명 — 암호화 저장(AES-256), UI 마스킹 |
protocol_config | 프로토콜설정 | JSONB | 소스유형별 프로토콜 상세 설정 |
description | 설명 | TEXT | 데이터소스 상세 설명 |
owner_id | 담당자ID | UUID (시스템참조) | 데이터소스 관리 담당자 |
tags | 분류태그 | JSONB | 분류 태그 |
erp_equipment_id | ERP설비ID | UUID (FK) | ERP 설비마스터 참조 |