고은별의 기술 공유 연구소

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.3.1

luvris2 — Thu, 17 Jul 2025 10:21:56 +0900

이전 버전 사용 시, 현재 실행 중인 프로그램을 반드시 종료해 주세요.

프로그램의 이상이 보인다면, '환경설정 -> 초기화' 기능을 이용해 주세요.

1.3.0 버전에서 발견된 버그가 수정된 버전입니다.

다운로드 링크

암호 : mobinogihelper

런타임패키지 포함 단일 파일 다운로드 링크

https://drive.google.com/file/d/1lGsVofpwzgvji4Aqb9uzB6K3eEX1Km8C/view?usp=sharing

모비노기도우미 v1.3.1_pwd.zip

drive.google.com

❓ 바이러스라고 다운로드가 안 돼요! / 바이러스라면서 다운로드하면 파일이 삭제돼요!

위 파일은 사용자의 편의성을 위하여 프로그램 실행에 필요한

모든 구성요소를 자체적으로 포함한 버전입니다.

때문에 단일 exe 확장자 파일로 구성되며 용량이 다소 많아

특정 환경에서는 바이러스로 의심되는 것 같습니다.

바이러스 관련으로 모비노기 도우미 사용이 어려우신 분들은

아래의 '런타임 패키지 미포함 버전'을 다운로드하여주세요.

프로그램 실행 시 팝업 되는 설치 링크로 이동하여 반드시 런타임 패키지를 설치하여야만 모비노기 도우미를 이용할 수 있습니다.

런타임 패키지 미포함 모비노기 도우미 v.1.3.1

https://drive.google.com/file/d/175dTENq3HGlSuSZ8uxzXyrSLq8bwebSN/view?usp=sharing

MobinogiHelper v1.3.1.zip

drive.google.com

+ 추가 제보)

윈도우10에서는 바이러스로 여전히 다운로드되지 않는다는 제보가 있습니다.

마이크로소프트에서 지원 종료를 하기 때문에 가능하면 윈도우11을 사용해 주세요.

오류 수정사항

2025-07-17

보기 옵션의 '80% 작게 보기' 설정된 상태에서 캐릭터 추가 시 오류가 뜨는 현상 수정
스크롤 바가 이상하게 보이는 현상 수정
- 추가된 캐릭터가 5개 미만의 경우 스크롤 바 레이아웃 이상 현상 수정
- 보기 설정 변경 시, 숙제 리스트 탭의 스크롤 바 레이아웃 이상 현상 수정
초기화 기능 오작동 오류 수정

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.3.0

luvris2 — Sun, 13 Jul 2025 23:51:40 +0900

이전 버전 사용 시, 현재 실행중인 프로그램을 반드시 종료해주세요.

프로그램의 이상이 보인다면, '환경설정 -> 초기화' 기능을 이용해주세요.

'80% 작게 보기' 옵션 상태에서 캐릭터를 추가할 경우 오류가 발생하고 있습니다.

추 후 수정하여 업데이트 할 예정이니 불편하시더라도

'80% 작게 보기' 옵션은 모든 캐릭터와 콘텐츠가 추가 된 이후 보기 용도로 사용하시거나,

기존 보기 방법을 사용해주세요.

다운로드 링크

암호 : mobinogihelper

런타임패키지 포함 단일 파일 다운로드 링크

https://drive.google.com/file/d/1xVrTavZ1J2wl-03xq_hkKQHz--wXsYYM/view?usp=sharing

모비노기도우미 v1.3.0_pwd.zip

drive.google.com

❓ 바이러스라고 다운로드가 안돼요! / 바이러스라면서 다운로드하면 파일이 삭제돼요!

위 파일은 사용자의 편의성을 위하여

프로그램 실행에 필요한 모든 구성요소를 자체적으로 포함한 버전입니다.

때문에 단일 exe 확장자 파일로 구성되며 용량이 다소 많습니다.

이 부분에서 특정 환경에서는 바이러스로 의심되는 것 같습니다.

바이러스 관련으로 모비노기 도우미 사용이 어려우신 분들은

아래의 '런타임 패키지 미포함 버전'을 다운로드 받아주세요.

런타임 패키지가 포함되어 있지 않습니다.

프로그램 실행 시 팝업되는 설치 링크로 이동하여 반드시 런타임 패키지를 설치하여야만

모비노기 도우미를 이용할 수 있습니다.

런타임 패키지 미포함 모비노기 도우미 v.1.3.0

https://drive.google.com/file/d/15Im3v9skxCLwCxprQDf-szD_bNwrQu-U/view?usp=sharing

추가 및 수정사항

2025-07-06

주간 숙제 아이콘 추가
- 주말 어비스 : 주말 어비스 3회 클리어 퀘스트
- 주말 레이드 : 주말 레이드 1회 클리어 퀘스트
환경 설정 옵션 추가
- 보기 설정
  - 80% 작게 보기 : 기존 크기보다 80% 작은 크기로 UI 구성, 숙제 컨텐츠를 5칸씩 보이도록 함
  - 원래대로 보기 : 기존 크기 그대로 UI 구성, 숙제 컨텐츠를 4칸씩 보이도록 함
  - 옵션 추가로 인해 제작자 배너는 불필요해보여서 제거하였습니다.

2025-07-11

주간 숙제 아이콘 추가
- 어비스 교환 : 몰리NPC를 통해 심연의 화석을 붉은 심연의 화석으로 교환하는 것을 확인하기 위함

2027-07-13

생활 아이콘 추가
- 일일 물물교환
  - NPC : 셰이머스, 고양이상인
  - 물품 : 뛰어난붕대, 하트토큰
- 주간 구매 물품
  - NPC : 엔델리온, 크리스텔
  - 물품 : 성수

미리보기

주간 컨텐츠 아이콘 추가

주말 어비스
주말 레이드
어비스 교환

추가된 주간 컨텐츠 아이콘 이미지

생활 컨텐츠 아이콘 추가

추가된 물품 아이콘

추가된 'NPC별 물품별 상세히 보기' 아이콘 이미지

추가된 NPC 아이콘

추가된 'NPC 아이콘만 보기' 아이콘 이미지

환경 설정 옵션 추가

환경설정 탭에서 '보기 설정' 옵션을 조정할 수 있습니다.

환경설정에서 확인 가능한 보기 설정 옵션 미리보기 화면

각각의 옵션이 적용된 실제 사용 화면 예시

좌: 원래대로 보기 / 우 : 80% 작게 보기

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.2.1

luvris2 — Mon, 23 Jun 2025 14:28:46 +0900

다운로드 링크

암호 : mobinogihelper

https://drive.google.com/file/d/1HG9u1WUpgnGRKVS2EFVqxyuQNkmnAw_7/view?usp=sharing

추가 및 수정 사항 요약

2025-06-20

유저 편의성 개선 작업
- 커스텀 콘텐츠 아이콘 추가 시, 컨트롤을 눌러서 추가했었어야 하는 번거로움 제거
- 마우스 클릭으로 선택 / 선택 해제가 가능하도록 변경
- 콘텐츠 아이콘 선택 시 유저가 직관적으로 순서를 확인할 수 있도록 순서 표시
사용자가 선택한 숙제 리스트가 간헐적으로 순서 상관없이 뒤죽박죽으로 나타나는 현상 수정

2025-06-22

물물 교환 업데이트(물품 변경)로 인한 아이콘 추가 및 변경

2025-06-23

레이드 아이콘을 삭제하고 글라스기브넨, 화이트 서큐버스 아이콘 새로 추가
v1.2.1 버전 배포

유저 편의성 개선

체크할 숙제 콘텐츠를 추가하는 방식 변경

기존
1. 컨트롤 키를 누르고 선택
2. 확인을 누르면 선택한 순서대로 추가

기존 콘텐츠 추가 방식 예시 화면

변경
1. 마우스 클릭으로 해당 콘텐츠를 선택/선택 해제 할 수 있도록 변경
  - 선택한 순서를 사용자가 직관적으로 확인할 수 있도록 선택 순서 표시
2. 순서를 확인한 뒤, 확인을 눌러 콘텐츠 추가

+ 의미 없던 가로 스크롤 바 제거

변경된 콘텐츠 추가 방식 예시 화면

콘텐츠 아이콘 추가 및 변경

레이드 아이콘

기존 레이드가 글라스기브넨 하나뿐이였으나,

6월 23일 화이트 서큐버스 레이드가 추가 되었음.

이에 따라 레이드 아이콘을 '글라스기브넨'과 '화이트 서큐버스'로 분리

변경 전 : 레이드
변경 후 : '글라스기브넨', '흰큐버스' 두 개의 아이콘으로 분리

콘텐츠 아이콘 변경

추가

아르미스 일일 교환 추가

변경

물물교환 물품 변경으로 인한 아이콘 변경

NPC별 물품 상세히 보기
- 발터 : 상급 목재 > 가죽
- 칼릭스 : 최상급 목재 > 가죽+

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.2.0

luvris2 — Thu, 19 Jun 2025 17:16:32 +0900

다운로드 링크

암호 : mobinogihelper

https://drive.google.com/file/d/1nobmkq-uJKmo-z6GtIyh8YZji_pX48yY/view?usp=sharing

추가 및 수정 사항

2025-06-18

프로그램 실행 시, 최신 버전 확인 및 업데이트 알림 기능 추가
- 최신 버전 존재할 경우, 해당 알림을 누르면 다운로드 페이지로 이동
숙제 및 생활 관련 리스트 스크롤 시, 좌측의 메인 타이틀은 움직이지 않도록 수정
콘텐츠 아이콘 관련
- 일일 및 주간 숙제 콘텐츠 일부 디자인 수정
- 숙제 콘텐츠 아이콘 추가
  - 일일 숙제 콘텐츠 아이콘 추가 : 일일 미션
  - 주간 숙제 아이콘 변경 : 별의 인장 -> 마물 퇴치 증표
환경 설정 : 결계 알리미 관련
- '결계 숙제 끝나면 알리미 끄기' 옵션 추가
  - 모든 캐릭터가 결계 횟수를 소진하면, 해당 옵션 선택 시 알리미 비활성화

2025-06-19

숙제 초기화 로직 변경
- 다문화권 시간 체계(윈도우 시간 표시가 다른 환경)를 수용하도록 수정
반호르 관련 생활 콘텐츠 아이콘 추가
v1.2.0 버전 배포

업데이트 알림 기능 추가

업데이트 버전이 존재하면 하단에 업데이트 알림이 뜨며,

원하지 않을 경우 우측의 'X'를 눌러 해당 알림을 끌 수 있습니다.

업데이트 버전은 해당 알림을 누르면 다운로드 페이지로 이동합니다.

이 기능은 현재 버전에서 확인 불가하며,

이후 추가 버전 업데이트 시 확인 가능합니다.

업데이트 알림 예시 화면

숙제 및 생활 관련 편의성 개선

숙제 혹은 생활 리스트 스크롤 시,
좌측의 메인 타이틀은 움직이지 않도록 수정

리스트를 스크롤 한 예시 화면, 오늘의 숙제와 이번주 숙제는 고정되도록 변경되었음

결계 알리미 관련

'결계 숙제 끝나면 알리미 끄기' 옵션 추가

모든 캐릭터가 결계 횟수를 모두 소진할 경우,

사용자가 따로 결계 알리미를 끌 필요 없이

알리미가 비활성화되도록 옵션 추가

결계 알리미 옵션 예시 화면

콘텐츠 아이콘 관련

추가

일일 숙제 콘텐츠
- 일일 미션
구매 및 교환 콘텐츠
- 반호르 관련

변경

주간 숙제 콘텐츠
- 별의 인장 > 마물 퇴치 증표

수정

일부 일일 및 주간 숙제 콘텐츠 아이콘 디자인 수정

오류 수정

숙제 초기화 관련

UTC(협정 세계시)를 사용하여,

시간 표기 체계가 다를 시스템(예1: 2025-06-19, 예2: 2025-06-19 목 등등)에서도

숙제 초기화가 이상 없이 작동하도록 변경

반드시 '환경설정 - 초기화'를 진행 한 후 프로그램 사용을 권장드립니다.

한국 시간 표시 체계 예시

영어권 시간 표시 체계 예시

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.1.1_fix

luvris2 — Sun, 15 Jun 2025 16:47:34 +0900

https://gall.dcinside.com/mgallery/board/view?id=mabinogimobile&no=988305

매일, 매주 반복되는 숙제… 이제는 더 간편하게 관리해보자! '0'
버전1.0에 이은 컨텐츠 추가 및 유저 커스텀이 가능하도록 업데이트된 버전입니다.

✅ 다운로드 링크

비밀번호 : mobinogihelper

https://drive.google.com/file/d/1v7u-uyM7DXuMMNdtsw7rcIPNeCxze95y/view?usp=sharing

추가 및 수정 사항 (2025-06-18)

2025-05-25
- 캐릭터를 자유롭게 추가할 수 있도록 변경
  - 플러스 모양 아이콘을 눌러 캐릭터를 여러 개 추가할 수 있도록 기능 확장
  - 캐릭터 추가 시, 아이디를 기입할 수 있도록 변경 (아이디는 최대 4자까지 입력 가능함)
  - 기존 추가된 캐릭터의 아이디 또한 변경 가능하도록 변경
2025-05-27
- 트레이 기능 추가
2025-05-29
- 숙제 리스트의 새로운 컨텐츠 아이콘 추가
- 컨텐츠 확인을 사용자가 유동적으로 할 수 있도록 커스텀 기능 추가
  - 유저가 직접 컨트롤 키를 눌러 순서를 정하여 컨텐츠를 추가하여 관리할 수 있도록 함
2025-06-05
- 메모장 기능 추가
  - 2025-06-10 : 메모장 자동 저장 기능 추가 (매 30분 마다)
  - 2025-06-10 : 프로그램 종료 시 메모 내용 자동 저장
2025-06-06
- 실행 폴더에 설정 파일(settings.ini)을 생성하지 않도록 변경
2025-06-11
- 생활 관련 컨텐츠 아이콘 추가
2025-06-12
- 환경 설정 기능 추가
  - 옵션 : 결계 알리미 관련
    - 결계 알리미를 '숙제 리스트' 탭이 아닌 '환경설정' 탭으로 이동
    - 결계 알리미 디자인 변경
  - 옵션 : 프로그램 닫기 관련
    - 프로그램 종료를 누를 경우, 선택된 옵션에 따라 작동하도록 변경
      - 프로그램 종료하기 : 닫기 버튼을 누를 경우, 프로그램이 종료 됨
      - 트레이로 보내기 : 닫기 버튼을 누를 경우, 트레이로 이동되며 창은 사라짐
- 도네이션 배너 제작 및 프로그램 환경설정 탭 내 배치
2025-06-14
- 캐릭터 추가 기능 관련
  - 캐릭터 추가 UI 변경
  - 캐릭터 추가 시 이미지를 선택하여 유저가 직접 캐릭터 이미지를 추가할 수 있도록 함
  - 이미지 프리셋 18종 추가
  - 이미지는 제공되는 프리셋 또는 직접 이미지를 불러와 추가할 수 있음
- 환경 설정 기능 추가
  - 프로그램 초기화 : 모든 설정 및 추가한 캐릭터까지 모두 초기화되도록 함
  - 횟수 초기화 알림 창 UI 변경
2025-06-15
- 프로그램 중복 실행 시, 기존 실행중인 프로그램을 활성화하도록 변경
- 프로그램의 마지막 실행 위치를 기억하여 다음 실행 시 해당 위치로 실행되도록 변경
- 프로그램의 사이즈를 조절할 수 있도록 변경
- 모비노기 도우미 1.1 버전 배포
2025-06-17 (버그 픽스 버전 v1.1.1)
- 오류 수정
  - 프로그램이 꺼진 상태로 초기화 타임이 지날 경우, 콘텐츠가 초기화되지 않는 현상 수정
  - 결계 3분 타이머에 글꼴이 적용되지 않은 현상 수정
  - 간헐적으로 시스템 시간 오류로 인해 프로그램이 정상적으로 실행되지 않던 현상 수정
    - 이전 버전(1.0)에서 사용자분들께서 말씀하셨던 settings.ini 파일 관련 오류입니다.
  - 해상도가 다른 컴퓨터에서 프로그램이 이상하게 보이는 현상 수정
- 추가
  - 환경 설정에 디스코드 서버로 이동하는 배너 버튼 추가
2025-06-18 (초기화 오류 재수정 버전 v1.1.1_fix)
- 숙제 초기화 로직에 잘못된 변수가 사용되어 정상 작동하지 않은 것을 확인, 수정 버전 재배포

앞으로 업데이트 예정 리스트

업데이트 예정 리스트는 작업 목록에 있으나 반드시 업데이트 된다는 것을 의미하진 않습니다.

결계 기능 관련
- 알림 소리 조절
- 알림 소리를 사용자가 원하는 소리로 변경
- 알림 소리 음소거
사용자가 컨텐츠 추가 시, 편의성 개선 작업 (컨트롤 키로만 추가하는 번거로움을 없앨 예정)
6월 19일 새로 추가될 컨텐츠 추가

발견된 이슈

이슈 제보 바람

프로그램 소개

이 프로그램은...
게임 컨텐츠 관리에 보다 직관적이고 효율적으로
숙제를 확인하고 관리할 수 있도록하기 위해 제작되었습니다.

모비노기 숙제 도우미 1.1 버전 사용 화면

✨ 모비노기 숙제 도우미란?

마비노기 모바일 유저들을 위해 제작된,
효율적이고 직관적인 일일/주간 숙제를 손쉽게 체크하기 위한 프로그램입니다.
매일 또는 주간 단위로 반복되는 콘텐츠들의 진행 여부를 체크할 수 있으며,
매일 오전 6시, 주간 숙제 초기화 시 자동으로 리셋되어
귀찮은 수동 초기화 없이 깔끔하게 숙제를 관리할 수 있도록 설계되어 있습니다.

사용 가능한 환경

OS : Windows 한정, 오직 윈도우에서만 실행 가능!

주요 기능들을 소개해볼게요!

주요 기능

✅ 일일/주간 콘텐츠 체크 기능

숙제를 완료했는지 헷갈릴 틈 없이 한 눈에 확인!
매일, 매주하는 숙제 자동 초기화!
번거로운 수동 관리 없이, 숙제 체크는 이 도우미 하나면 OK!

일일/주간 숙제 관리 예시

나만의 캐릭터로, 더 몰입감 있게!

이제 당신의 캐릭터를 도우미 안에 직접 등록해보세요!
캐릭터가 담긴 이미지를 업로드하면,
숙제 도우미 화면에서 나만의 아바타와 함께 숙제를 관리할 수 있습니다.

캐릭터 이미지를 넣기 귀찮으신 분들은 기본적으로 제공되는 프리셋을 이용해도 좋아요!
제 캐릭터와 지인들의 모습을 프리셋으로 넣었어요! :)

어떻게 활용되나요?

캐릭터 프로필 이미지로 등록되어, 숙제 리스트에 함께 표시
부캐릭터를 여러 개 등록했다면, 각 캐릭터별 이미지로 쉽게 구분
단순한 숙제 도우미를 넘어, 내 캐릭터 중심의 UI로 감정 몰입도 UP!

️ 사용 방법도 간단해요!

초록색 플러스 버튼을 누르거나 이미 생성되어 있는 캐릭터 클릭
캐릭터 이름을 입력 후, “이미지 불러오기” 버튼 클릭
내 PC에서 원하는 캐릭터 스크린샷 선택
'확인 버튼' 클릭! 등록 완료! 숙제 화면에서도 이미지가 바로 반영됩니다.

캐릭터를 추가하는 예시 화면

✏️ 내가 원하는 숙제, 직접 추가하세요! – 커스텀 콘텐츠 등록 기능

사용자가 직접 원하는 콘텐츠를 자유롭게 추가할 수 있도록 커스텀 등록 기능을 제공합니다!

이런 상황, 다들 한 번쯤 있지 않으셨나요?

"내가 따로 챙기는 숙제가 있는데, 기본 목록에 없어서 불편해!"
"따로 체크하고 싶은 숙제가 있는데 정리가 안 돼…"

이럴 때 커스텀 기능을 사용하면,
✔️ 일일/주간 단위 선택까지 자유롭게 설정
✔️ 체크 및 초기화 관리도 기본 콘텐츠와 동일하게 가능!

즉, 숙제 도우미를 통해 나만의 맞춤형 관리 도구로 사용할 수 있어요.

콘텐츠를 직접 골라 추가하는 예시 화면

콘텐츠를 추가할 때에는 컨트롤(Ctrl) 키를 눌러 순서를 정하고, 확인을 눌러주세요!
확인을 누르면 선택한 콘텐츠들로 재배치됩니다.

추가된 콘텐츠 미리 보기

✅ 오늘의 숙제 아이콘 목록

✅ 이번주 숙제 아이콘 목록

생활 콘텐츠도 이제 꼼꼼하게! – 세분화된 생활 숙제 관리 기능 추가

다양한 생활 관련 콘텐츠도 세부적으로 관리할 수 있도록 기능을 강화했습니다.
물품별로 관리하고 싶은 사람, 간단하게 NPC로만 관리하고 싶은사람...
"당신이 뭘 좋아할지 몰라서 다 준비했어! "

어떤 점이 좋아졌나요?

일일 교환, 주간 구매 숙제 항목을 구분해 보기 쉽게 정리
생활 관련 숙제를 자주 챙기는 유저들에게는, 놓치기 쉬운 세세한 부분까지 챙길 수 있도록 커스텀 맞춤형 기능!

⚙️ 더 나에게 맞게! – 환경 설정 옵션으로 보기 방식을 자유롭게 조절하세요

숙제 도우미는 사용자 편의성을 최우선으로 생각했어요.
그래서 생활 숙제를 얼마나 간단하게 또는 자세하게 볼지, 환경 설정에서 직접 선택할 수 있도록 했습니다!
기본적으로는 'NPC별 물품 상세히 보기'로 보이도록 되어 있어요.
이 옵션은 선택 한 후, 콘텐츠를 추가할 때부터 적용됩니다.
이를 이용해 일일 교환은 물품별로, 주간 교환은 NPC별로 하는 등, 여러 가지 형태로 설정 가능해요.

⚙️ 환경 설정 > 구매 및 교환

환경설정 탭에서 '구매 및 교환'의 옵션 예시 화면

NPC 아이콘만 보기
- 각 교환 및 구매를 담당하는 NPC 이름만으로 간단하게 표기
- 복잡하고 헷갈리기 쉬운 사람은 어떤 NPC를 찾아가야 하는지만 알면 되니, 훨씬 간결하고 직관적!
NPC별 물품 상세히 보기 (기본값)
- 꼼꼼히 숙제를 체크하고 싶은 유저에게 최적화!
- 구매 및 교환에 필요한 세부 항목이 나열되어 디테일하게 콘텐츠 관리 가능!

상품별, NPC별 옵션을 설정해서 구매 및 교환의 콘텐츠를 추가하는 예시 화면

콘텐츠를 추가할 때에는 컨트롤(Ctrl) 키를 눌러 순서를 정하고, 확인을 눌러주세요!
확인을 누르면 선택한 콘텐츠들로 재배치됩니다.

추가된 콘텐츠 아이콘 미리 보기

✅ NPC 아이콘만 보기

오늘의 교환 물품

오늘의 교환 물품, NPC 아이콘만 보기

이번주 구매 물품

이번주 구매 물품, NPC 아이콘만 보기

✅ NPC별 물품 상세히 보기

오늘의 교환 물품

오늘의 교환 물품, NPC별 물품 상세히 보기

이번주 구매 물품

이번주 구매 물품, NPC별 물품 상세히 보기

❓ 숙제 체크를 잘못했을 때에는? 실수해도 괜찮아요!

가끔 숙제를 체크하면서 실수로 완료 체크를 눌렀다든지,
구멍과 결계 숙제의 횟수를 잘못 체크하는 일이 생기곤 하죠.
이럴 때를 대비해, 사용자가 직접 숙제 체크 기록을 초기화할 수 있어요!

사용자가 숙제를 체크/체크해제하고 횟수를 수동으로 초기화하는 예시화면

❓숙제 콘텐츠가 계속 하나만 추가되요!

현재 콘텐츠 커스텀 추가 기능은 컨트롤을 통해서 여러 개를 선택 한 후 확인을 누르면
선택된 콘텐츠들이 새롭게 재배치되는 구조로 설계되어 있습니다.
기존에서 추가되는 개념이 아닌, 새롭게 선택한 콘텐츠들로 재구성되는 거죠.

내 숙제, 내 방식대로 정리한다 – 메모장 기능 추가!

이제 숙제 도우미에서 자유롭게 메모를 작성하고 관리할 수 있어요.
숙제 리스트만으로는 부족했던 정보들, 이제는 직접 적고 정리하세요!

✨ 어떤 걸 쓸 수 있나요?

내가 따로 관리하는 추가 숙제나 체크할 정보
이벤트 아이템 교환 일정, 교환 우선순위 정리
부캐릭터별 해야 할 작업 간단히 정리
타인과의 약속, 협동 퀘스트 예약 메모까지!

주요 기능

간단하고 빠르게 입력 가능한 자유 메모 공간 제공

메모는 30분마다 자동 저장되어, 예기치 못한 상황 방지
프로그램 종료 시 메모를 저장하기 때문에 따로 저장할 필요 없음!

당신만의 마비노기 일지를 함께 써 내려가는 공간,
숙제도, 일정도, 아이디어도 자유롭게 기록하세요.

메모장 사용 예시

결계 알림 기능

매 시간마다 생성되는 ‘결계’, 깜빡하지 않도록 알림으로 챙기자!
한 번 놓치면 다음 기회를 기다려야 해서, 상당히 귀찮죠 ㅠ3ㅠ
그래서 숙제 도우미는 결계 시간에 맞춰 총 4단계 알림을 제공해요!
모든 알림은 윈도우 화면 우측 하단 (시계 위)에 알림 팝업이 출력됩니다.
결계 설정은 프로그램 상단 탭 '환경설정'에서 설정 가능해요.

⚙️ 환경 설정 > 결계 알리미

결계 알리미 설정 예시 화면

PS. 예시 화면으로 제공된 화면은 테스트 화면이므로 윈도우의 실제 시간은 무시해주세요.

⏰ 10분 전 / 5분 전 미리 알림

미리미리 준비할 수 있도록 여유 있게 확인하자!
시간에 쫓기지 않고 여유롭게 결계를 준비할 수 있도록 해주는 기능입니다.
이 알림은 사전 준비용입니다. 아직 던전을 돌고 있다면 빠르게 마무리해서 결계를 준비해보세요!
결계가 실제로 생성되는 시간(정각) 10분 혹은 5분 전에 미리 알림이 울립니다.
사용자가 현재 게임에 집중하지 않고 있더라도 "결계 알리미"를 통해 결계를 인지할 수 있어요.

결계 생성 10분 전과 결계 생성 5분 전 알림 팝업 예시 화면

⏰ 정각 알림 – 결계가 생성되면 즉시 알림!

결계가 실제로 생성되는 시간(정각)에 알림이 울리도록 해주는 기능입니다.
이 알림을 통해 결계가 시작되기 전 사용자는 미리 준비를 할 수 있도록 해주는 역할을 해요.
단, '결계 시작 3분 타이머 기능'을 사용할 경우 해당 알림은 노출되지 않고 타이머가 노출되요!

정각마다 생성되는 결계 생성 알림 예시 화면

⏳ 결계 시작 3분 전 타이머 알림 – 결계 시작 전 집중 준비 시간 확보!

결계 앞에 세워두고 언제 시작하나 확인하기 너무 귀찮으시죠?
결계 생성 후 실질적으로 결계를 시작하는 시간을 타이머로 알려줍니다.
결계 생성부터 시작까지(총 3분)의 남은 시간이 보여주며, 실질적인 시작 타이밍에 맞춰 사용자가 놓치지 않게 도와주는 기능을 합니다.

결계 시작 3분 타이머 예시 화면

️ 결계 알림 팝업은 윈도우 좌측 하단에서 확인! – '아.. 맞다.. 결계!' 게임 중에도 알림을 놓치지 말자!

모든 결계 알림은 윈도우 화면 우측 하단에 팝업으로 표시됩니다.
마비노기 모바일을 하거나, 다른 작업을 하다가도 알림이 시각적으로 띄워져 즉시 확인 가능해요.
'띵!' 소리와 함께 팝업이 노출되도록 되어 있어요.

️ 깔끔하게 종료하거나, 조용히 숨겨두거나 – 트레이 기능 추가

‘닫기 설정’으로 나에게 맞는 방식 선택!
사용자 환경에 맞게 프로그램 종료 방식을 선택할 수 있도록 ‘닫기 설정’ 기능을 제공합니다.
창을 닫을 때 어떻게 동작할지 직접 설정해보세요!

⚙️ 환경 설정 > 닫기 설정

두 가지 모드 중 원하는 방식으로 선택할 수 있어요

닫기 설정 예시 화면

프로그램 종료하기 (기본값)
- 창 닫기(X 클릭) 시, 모비노기 도우미가 완전히 종료됩니다.
- 리소스를 아끼고 싶거나, 필요할 때만 실행하고 싶은 분께 적합!
트레이로 보내기
- 창 닫기 시, 프로그램이 완전히 종료되지 않고 작업 표시줄 트레이로 최소화됩니다.
- 백그라운드에서 조용히 실행되며, 알림 기능(예: 결계 알림 등)은 그대로 유지됩니다.
- 게임 중 방해되지 않고, 불필요한 창이 계속 떠 있는 것을 방지할 수 있어요.

특히 ‘트레이로 보내기’는
결계 알림만 받고 싶을 때, 수시로 도우미를 꺼내 쓰고 싶을 때 아주 유용합니다!
당신의 사용 스타일에 맞춰, 모비노기 도우미의 종료 방식도 유연하게!

문제가 생겼을 땐, 처음으로!

‘환경 설정 > 초기화’ 기능으로 프로그램을 원래 상태로 복원!
간혹 프로그램 사용 중 오류가 발생하거나, 설정이 꼬여버렸을 때
“그냥 싹 다 초기화하고 처음부터 다시 설정하고 싶다!” 싶은 순간이 있죠?
이 기능은 다음과 같은 상황에서 유용해요

프로그램에 이상한 버그가 생겼을 때
설정을 너무 많이 바꿔서 되돌리기 복잡할 때
다른 캐릭터로 완전히 새로 시작하고 싶을 때

그럴 때를 위해 ‘초기화’ 기능을 제공합니다.
환경 설정 메뉴에서 '초기화' 버튼을 클릭하면,
모든 데이터를 지우고 처음 설치했을 때의 상태로 되돌릴 수 있어요.

⚠️ 초기화 시 주의사항!

설정한 모든 옵션이 사라집니다.
메모장에 작성한 모든 내용도 삭제됩니다.
커스텀 숙제, 캐릭터 이미지, 환경설정, 알림 옵션 등도 모두 초기화됩니다.

정말 초기화를 진행할 경우,
“모든 정보를 초기화하시겠습니까?”라는 확인창이 한 번 더 뜨니 실수 걱정은 줄였습니다.

참고

이미지 관련 - DALL-E
동영상 관련 - Runway
사용된 글꼴 - 배달의민족 주아체

사용 스킬

C# (.NET 8.0) Winfoms

Firebase RealtimeDatabase

프로그램 개발 히스토리

2025-05-01

결계 타이머 기능
- 3시간 간격, 결계 시작 10분 전 타이머 기능 개발
- 윈도우 화면 우측 하단(시계 바로 위)에 결계 알림 팝업창을 출력하도록 추가

2025-05-15

사용자가 직관적으로 사용할 수 있도록 UI 변경
- 여러가지 일일/주간 컨텐츠를 확인할 수 있도록 프로그램 디자인 변경
- 컨텐츠 클리어 유무를 체크할 수 있도록 기능 추가 (체킹, 횟수 카운트다운)
- 각 컨텐츠의 남은 시간을 확인할 수 있도록 남은 시간 표기

2025-05-16

마우스 커서 추가
숙제 여부를 프로그램 종료 후 재시작 시 유지되도록 변경 (설정파일 추가)

2025-05-22

매일 오전 6시, 월요일 오전 6시마다 일일/주간 숙제 자동 초기화
결계 타이머 기능 수정 및 UI 보완
- 1시간 간격으로 기능 수정
- 결계 타이머 기능 추가
  - 5분 전 알림
  - 결계 시작 전 3분 타이머
    - 시작 전 3분 타이머 기능 활성화 시, 결계가 생성되고부터 시작될때까지 팝업으로 시작되기까지의 잔여시간을 팝업창으로 보여줌
각 알림별 팝업 디자인 추가
팝업 닫기 기능 추가

2025-05-23

결계 알림 팝업 시, 게임 플레이 중 동작을 방해하지 않도록 수정
v1.0 배포

2025-05-25

기존 프로그램 코드 재정의
- 커스텀 추가를 위해 기존의 로직 전체를 수정하는 방향으로 진행
캐릭터 커스텀 기능 추가
- 캐릭터를 여러 개 추가할 수 있도록 기능 확장
  - 플러스 모양의 아이콘을 눌러 진행함
- 캐릭터명 설정 기능 추가
  - 캐릭터 확장 버튼 클릭 시, 캐릭터명을 설정할 수 있도록 변경
  - 이름을 잘못 입력하였을 경우, 캐릭터 아이콘을 클릭하여 캐릭명 수정 가능

2025-05-27

관리자 권한으로 실행할지 사용자에게 물어보고 실행하도록 변경
- 관리자 권한으로 실행하지 않을 경우, 프로그램을 실행할 수 없도록 함
  - 2025-06-15 : 해당 기능 비활성화
프로그램 중복 실행 방지 기능 추가
트레이 기능 추가

2025-05-29

새로운 컨텐츠 아이콘 추가
컨텐츠 확인을 유동적으로 할 수 있도록 커스텀 기능 추가

2025-06-04

상단의 탭 추가
- 생활 관련 탭 (일일&주간 교환 및 구매를 위한 체크 리스트)
- 메모장 탭
- 환경 설정 추가

2025-06-05

메모장 탭 기능 개발
- 메모장 탭에서 글 편집 기능 추가

2025-06-06

생활 관련 탭 기능 개발
- 생활 관련 탭 레이아웃 구성
- 설정 파일(settings.ini)을 모비노기 도우미 실행 폴더에 생성하지 않도록 변경
  - 설정 파일 저장 경로(사용자 로밍 폴더) : %appdata%\MobinogiHelper
  - 설정 파일명 : mobi_setting.ini

2025-06-08

설정 정보를 불러오는 내부 로직 변경

2025-06-10

메모장 탭 기능 개발 (가독성을 위해 윈도우 기본 글꼴 적용)
- 프로그램 종료 시 메모장 내용 저장 기능 추가
  - 메모 파일 저장 경로(사용자 로밍 폴더) : %appdata%\MobinogiHelper
  - 메모 파일명 : mobi_memo.txt
- 메모장 자동 저장 기능 추가 (매 30분마다 자동 저장)

2025-06-11

생활 관련 탭 기능 개발
- 컨텐츠 아이콘 추가
'배달의민족 주아체' 글꼴 적용

2025-06-12

환경 설정 탭 기능 개발
- 환경 설정 탭 레이아웃 구성
- 옵션: "결계 알리미" 관련
  - 결계 알리미를 숙제 탭이 아닌 환경 설정 탭으로 이동
  - 결계 알리미 디자인 변경
- 옵션: "프로그램 닫기" 관련
  - 프로그램 종료를 누를 경우, '종료'와 '트레이로 보내기' 택 1
도네이션 배너 제작 및 프로그램 내 탑재

2025-06-14

캐릭터 추가 기능 변경
- 캐릭터 추가 UI 변경
- 캐릭터 추가 시 이미지를 선택하여 캐릭터를 추가할 수 있도록 함
  - 이미지는 제공되는 프리셋 또는 직접 이미지를 불러와 추가할 수 있음
  - 프리셋 18종 추가
환경 설정 탭 기능 추가
- 프로그램 초기화 : 모든 설정 및 추가한 캐릭터 이미지 모두 초기화
횟수 초기화 알림 창 UI 변경

2025-06-15

프로그램 중복 실행 방지 기능 변경
- 중복 실행 시, 기존 실행중인 프로그램 활성화
프로그램 사용 위치 기억 기능 추가
- 프로그램 마지막 위치를 확인하여 다음 실행 시 해당 위치로 실행되도록 변경
프로그램의 사이즈를 조절할 수 있도록 변경
글꼴 폰트를 더욱 매끄럽고 부드럽게 보이기 하기 위해 GDI+ 방식 적용

2025-06-17

환경 설정 탭 기능 추가
- 디스코드 : 해당 배너 버튼을 누르면 도우미 디스코드 서버로 연결

2025-06-18

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.0

luvris2 — Fri, 23 May 2025 01:46:38 +0900

매일, 매주 반복되는 숙제… 이제는 더 간편하게 관리해보자! '0'

수정사항

2025-05-23 (v1.0.1)
- 4K 모니터, 화면 배율이 100%가 아닌 125%, 150% 등의 배율에서 프로그램의 글자 위치가 어긋나는 현상 수정

프로그램 소개

이 프로그램은...
게임 컨텐츠 관리에 보다 직관적이고 효율적으로
숙제를 확인하고 관리할 수 있도록하기 위해 제작되었습니다.

모비노기 숙제 도우미 v1.0 사용 화면

✨ 모비노기 숙제 도우미란?

✅ 다운로드 링크

https://drive.google.com/file/d/1Il2BbWb3mPFhLlRUAZPaMt7EBHZ5UZIe/view?usp=sharing

사용 가능한 환경

OS : Windows 한정, 오직 윈도우에서만 실행 가능!

주요 기능들을 소개해볼게요!

주요 기능

✅ 일일/주간 콘텐츠 체크 기능

숙제를 완료했는지 헷갈릴 틈 없이 한 눈에 확인!
매일, 매주하는 숙제 자동 초기화!
번거로운 수동 관리 없이, 숙제 체크는 이 도우미 하나면 OK!

일일/주간 숙제 관리 예시

❓ 숙제 체크를 잘못했을 때에는? 실수해도 괜찮아요!

사용자가 숙제를 체크/체크해제하고 횟수를 수동으로 초기화하는 예시화면

결계 알림 기능

매 시간마다 생성되는 ‘결계’, 깜빡하지 않도록 알림으로 챙기자!
한 번 놓치면 다음 기회를 기다려야 해서, 상당히 귀찮죠 ㅠ3ㅠ
그래서 숙제 도우미는 결계 시간에 맞춰 총 4단계 알림을 제공해요!
모든 알림은 윈도우 화면 우측 하단 (시계 위)에 알림 팝업이 출력됩니다.
결계 설정은 프로그램 오른쪽 아래에서 설정 가능해요.

결계 알리미 설정 예시 화면

PS. 예시 화면으로 제공된 화면은 테스트 화면이므로 윈도우의 실제 시간은 무시해주세요.

⏰ 10분 전 / 5분 전 미리 알림

미리미리 준비할 수 있도록 여유 있게 확인하자!
시간에 쫓기지 않고 여유롭게 결계를 준비할 수 있도록 해주는 기능입니다.
이 알림은 사전 준비용입니다. 아직 던전을 돌고 있다면 빠르게 마무리해서 결계를 준비해보세요!
결계가 실제로 생성되는 시간(정각) 10분 혹은 5분 전에 미리 알림이 울립니다.
사용자가 현재 게임에 집중하지 않고 있더라도 "결계 알리미"를 통해 결계를 인지할 수 있어요.

결계 생성 10분 전과 결계 생성 5분 전 알림 팝업 예시 화면

⏰ 정각 알림 – 결계가 생성되면 즉시 알림!

결계가 실제로 생성되는 시간(정각)에 알림이 울리도록 해주는 기능입니다.
이 알림을 통해 결계가 시작되기 전 사용자는 미리 준비를 할 수 있도록 해주는 역할을 해요.
단, '결계 시작 3분 타이머 기능'을 사용할 경우 해당 알림은 노출되지 않고 타이머가 노출되요!

정각마다 생성되는 결계 생성 알림 예시 화면

⏳ 결계 시작 3분 전 타이머 알림 – 결계 시작 전 집중 준비 시간 확보!

결계 앞에 세워두고 언제 시작하나 확인하기 너무 귀찮으시죠?
결계 생성 후 실질적으로 결계를 시작하는 시간을 타이머로 알려줍니다.
결계 생성부터 시작까지(총 3분)의 남은 시간이 보여주며, 실질적인 시작 타이밍에 맞춰 사용자가 놓치지 않게 도와주는 기능을 합니다.

결계 시작 3분 타이머 예시 화면

️ 결계 알림 팝업은 윈도우 좌측 하단에서 확인! – '아.. 맞다.. 결계!' 게임 중에도 알림을 놓치지 말자!

모든 결계 알림은 윈도우 화면 우측 하단에 팝업으로 표시됩니다.
마비노기 모바일을 하거나, 다른 작업을 하다가도 알림이 시각적으로 띄워져 즉시 확인 가능해요.
'띵!' 소리와 함께 팝업이 노출되도록 되어 있어요.

참고

이미지 관련 - DALL-E
동영상 관련 - Runway
사용된 글꼴 - 배달의민족 주아체

사용 스킬

C# (.NET 8.0) Winfoms

프로그램 개발 히스토리

2025-05-01

결계 타이머 기능
- 3시간 간격, 결계 시작 10분 전 타이머 기능 개발
- 윈도우 화면 우측 하단(시계 바로 위)에 결계 알림 팝업창을 출력하도록 추가

2025-05-15

사용자가 직관적으로 사용할 수 있도록 UI 변경
- 여러가지 일일/주간 컨텐츠를 확인할 수 있도록 프로그램 디자인 변경
- 컨텐츠 클리어 유무를 체크할 수 있도록 기능 추가 (체킹, 횟수 카운트다운)
- 각 컨텐츠의 남은 시간을 확인할 수 있도록 남은 시간 표기

2025-05-16

마우스 커서 추가
숙제 여부를 프로그램 종료 후 재시작 시 유지되도록 변경 (설정파일 추가)

2025-05-22

매일 오전 6시, 월요일 오전 6시마다 일일/주간 숙제 자동 초기화
결계 타이머 기능 수정 및 UI 보완
- 1시간 간격으로 기능 수정
- 결계 타이머 기능 추가
  - 5분 전 알림
  - 결계 시작 전 3분 타이머
    - 시작 전 3분 타이머 기능 활성화 시, 결계가 생성되고부터 시작될때까지 팝업으로 시작되기까지의 잔여시간을 팝업창으로 보여줌
각 알림별 팝업 디자인 추가
팝업 닫기 기능 추가

2025-05-23

결계 알림 팝업 시, 게임 플레이 중 동작을 방해하지 않도록 수정
배포

MSSQL - 테이블 저장 시 발생하는 오류 해결 방법 (Saving changes is not permitted.)

luvris2 — Wed, 16 Oct 2024 17:02:18 +0900

개요

요구하는 서비스에 따라 가끔은 데이터베이스의 테이블을 수정해야하는 경우가 있다.

특히 MS-SQL(SSMS)를 사용하면서 컬럼명을 추가/변경/삭제를 하게 되면 자주 볼 수 있는 오류인데,

테이블의 구조를 변경할 수 없다는 내용이다.

이번 글에서는 테이블 구조 변경 시 발생하는 오류가 왜 발생하는지의 원인과

간단한 해결 방법을 다뤄보려 한다.

Error

테이블의 구조를 변경하고 저장하려니 다음과 같은 오류가 발생한다.

Saving changes is not permitted.
The changes that you have made require the following tables to be dropped and re-created.
You have either made changes to a table that can't be re-created
or enabled the option Prevent saving changes that require the table to be re-created.

원인

이 오류 메시지는 SQL Server Management Studio (SSMS)에서

테이블의 스키마(열 정의, 데이터 형식 등)에 변경했을 때 발생하는 에러이다.

SSMS에서는 특정 변경 사항(예: 열의 추가, 데이터 형식 변경 등)이 발생하면,

테이블을 삭제하고 새로 생성하여 변경 사항을 적용하게 되는데,

SSMS의 기본 설정으로는 이러한 동작이 차단되도록 옵션이 설정되어 있기 때문에

테이블을 삭제 및 재생성해야 하는 변경을 허용하지 않아 발생하는 오류이다.

해결 방법

이 문제를 해결하려면, SSMS 설정에서 해당 옵션을 비활성화해야 한다.

SSMS에서 아래의 메뉴를 누른다.

Tools - Options
(한글판의 경우) 도구 - 옵션

옵션에서 아래의 해당 옵션을 체크 해제하고, 적용을 위해 OK를 눌러 옵션 적용을 마친다.

Designers - Table and Database Designers
- 'Prevent saving changes that require table re-creation' 체크 해제
(한글판의 경우) 디자이너 - 테이블 및 데이터베이스 디자이너
- '테이블을 다시 만들어야 하는 변경 내용 저장 사용 안함' 체크 해제

테스트

테이블의 컬럼을 추가 한 뒤, 테이블을 저장해보자.

아래와 같은 확인 문구가 출력된다.

"테이블이 데이터베이스에 저장됩니다. 계속하시겠습니까?"

이제 'Yes'를 누르면 구조가 변경된 테이블을 저장할 수 있게 된다.

테이블 구조 변경 시 테이블이 삭제 후 재생성 되는 이유는?

MS-SQL에서 테이블 구조를 변경할 때 테이블이 삭제되고 새로 생성되는 이유는

일부 스키마 변경 사항이 테이블의 물리적 데이터 저장 구조에 영향을 미치기 때문이다.

이 경우, 테이블의 기존 구조를 그대로 유지하면서 스키마를 수정하는 것이 불가능하기 때문인데,

SQL Server는 테이블을 삭제하고 재생성하는 방식으로 변경 사항을 적용한다.

이 방법은 변경된 스키마가 데이터베이스 엔진에 올바르게 반영되도록 보장한다.

조금 더 풀어쓰면,

테이블의 스키마가 변경되면 SQL Server는 모든 데이터 페이지를 다시 작성해야 할 수도 있기 때문이다.

새로 추가된 열의 공간을 확보하거나 삭제된 열의 데이터를 제거하는 작업이 필요한데

이 경우, 단순히 테이블의 메타데이터만 수정하는 것이 아니라 물리적인 데이터 저장 방식을 변경해야 할 수 있다.

또한, 열의 데이터 형식을 변경하는 경우에도 기존 데이터의 형식을 새로운 형식에 맞게 변환하는 과정에서도

테이블의 모든 행을 검사하고 데이터 형식을 변환한 후, 새로운 형식으로 다시 저장해야 하기 때문에

기존 테이블을 삭제하고 새로 생성하는 과정을 필요로 한다.

Docker Desktop Error - Virtual Machine Platform is not enabled. Enable it using the following PowerShell script ~

luvris2 — Tue, 8 Oct 2024 13:34:46 +0900

Error

Docker Desktop - Virtual Machine Platform is not enabled.
Enable it using the following PowerShell script (in an administrative PowerShell)
and then restart your computer before using Docker Desktop:

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

이 오류는 Docker Desktop을 실행할 때 Windows에서

Virtual Machine Platform 기능이 활성화되지 않아서 발생하는 오류이다.

Docker Desktop이 WSL2를 사용하려면 이 기능이 필수적으로 활성화되있어야 한다.

해결 방법

해결 방법은 오류 문구에 나와있다.

스크립트를 그대로 파워쉘에 입력하면 된다.

Virtual Machine Platform을 활성화해보자.

PowerShell을 관리자 권한으로 실행하기

Windows 검색창에서 "PowerShell"을 검색한다.
Windows PowerShell을 마우스 오른쪽 클릭 후 "관리자 권한으로 실행"을 선택한다.

Virtual Machine Platform 활성화하기

PowerShell에서 다음 명령어를 입력한다.

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

이 명령어는 Windows의 Virtual Machine Platform 기능을 활성화하는 명령어이다.

명령어를 입력하면 컴퓨터를 재시작할 것이냐고 묻는다.

YES를 입력해서 시스템을 재부팅하자.

시스템 재부팅 후

시스템이 재부팅되면 도커 데스크톱을 실행시켜보자.

이제 오류없이 정상적으로 잘 구동되는 것을 확인할 수 있다.

MSSQL - 빠르게 알아보는 데이터베이스 용량 경량화하기 (데이터 및 로그 축소)

luvris2 — Wed, 2 Oct 2024 13:07:59 +0900

데이터베이스의 용량을 축소하려면 크게 두 가지의 구문으로 나뉜다.

이는 사용자의 선택에 따라 사용하면 될 듯하다.

DBCC SHRINKDATABASE 구문

DBCC SHRINKDATABASE(데이터베이스명, 여유공간사이즈)

데이터베이스의 파일(데이터, 로그)을 축소하여 디스크 공간을 회수하는 데 사용하는 명령어
첫 번째 파라미터 : 축소하려는 데이터베이스의 이름을 입력
두 번째 파라미터 : 선택사항, 데이터베이스 파일 내에서 남겨둘 여유 공간의 비율 입력
- 예시1) 만약 '10'의 값을 입력할 경우에는 10% 여유 공간을 남김
- 예시2) 파라미터의 값을 입력하지 않으면 여유 공간 없이 축소 진행

DBCC SHRINKFILE 구문

DBCC SHRINKFILE (파일이름, 축소할용량);

특정 파일의 크기를 축소하여 사용하지 않는 디스크 공간을 회수하는 데 사용하는 명령어
첫 번째 파라미터 : 축소하려는 파일의 이름 입력
두 번째 파라미터 : 축소하려는 목표 파일의 크기(MB 단위) 입력
- 예시1) 5의 값을 입력할 경우, 최대 5메가까지 축소 작업을 시도함

테스트 시나리오: 데이터베이스의 전체 파일 용량 축소하기

-- 현재 데이터베이스의 파일명을 모를 경우의 용량 확인
use xxx
exec sp_helpfile -- xxx 데이터베이스 데이터 파일 용량 415기가 / 로그 용량 91기가

-- DB 작업 축소 전 용량 확인
use xxx
SELECT name AS [파일명], size * 8 / 1024 AS [크기(MB)]
FROM sys.master_files
WHERE type_desc = 'ROWS' and name = 'xxx' -- 데이터 파일 축소 전 : 415816 MB

-- 필요 없는 데이터 삭제
delete from ~
truncate table ~

-- 데이터베이스 용량 축소
DBCC SHRINKDATABASE(xxx)

-- DB 작업 축소 후 용량 확인
use xxx
SELECT name AS [파일명], size * 8 / 1024 AS [크기(MB)]
FROM sys.master_files
WHERE type_desc = 'ROWS' and name = 'xxx' -- 데이터 파일 축소 전 : 92547MB

테스트 시나리오: 개발 환경에서의 로그 파일 용량 축소하기

복구 모델에 따라 용량 축소하는 방법이 다르다.

테스트 시나리오에서는 '전체 복구 모델'을 '간단 복구 모델'로 변경하여

로그의 정보를 백업하지 않고 날려버린 채 경량화 작업을 진행하도록 구성하였다.

이는 개발 환경에서는 상관없으나 실제 서비스 중인 데이터베이스에서는 위험할 수 있다.

-- DB 작업 축소 전 용량 확인
use xxx
SELECT name AS [파일명], size * 8 / 1024 AS [크기(MB)]
FROM sys.master_files
WHERE type_desc = 'LOG' and name = 'xxx_log' -- 로그 파일 축소 전 : 91528 MB

-- 로그를 아예 날려버리기 위해 간단 복구 모델로 변경
ALTER DATABASE xxx SET RECOVERY SIMPLE

-- 로그 파일 축소
DBCC SHRINKFILE (xxx_log, 5);  -- 5MB로 축소

-- 복구 모델을 다시 전체 복구로 변경
ALTER DATABASE xxx SET RECOVERY FULL

-- DB 작업 축소 후 용량 확인
use xxx
SELECT name AS [파일명], size * 8 / 1024 AS [크기(MB)]
FROM sys.master_files
WHERE type_desc = 'LOG' and name = 'xxx_log' -- 축소 후 : 5 MB

✅ 이 내용을 더 자세히 알아보려면?

이 글은 핵심 내용만 요약하여 빠르게 사용할 수 있도록 작성되었다.

데이터베이스 용량 관리에 대한 내용과 데이터베이스 용량 사이즈를 경량화할 때

복구 모델이 어떻게 사용되는지에 대한 자세한 설명은 아래의 링크에서 자세히 확인 가능하다.

MSSQL – 데이터베이스 용량 및 로그 사이즈 축소하기

MSSQL - 데이터베이스 용량 및 로그 사이즈 축소하기 - 은별 월드

혹시 데이터베이스 용량 때문에 고민해본 적이 있을까? 서비스를 운영하다 보면 자연스레 데이터가 계속 쌓이면서 데이터베이스 용량이 증가하고어느샌가 알게 모르게 디스크 공간이 부족해지

eunbyeol.co.kr

Android Studio - We recommend using a newer Android Gradle plugin to use compileSdk xx

luvris2 — Thu, 19 Sep 2024 12:04:42 +0900

경고 메시지 발생

구글 플레이에 출시되어 있는 앱을 API 34 수준의 요구사항을 타겟팅을 해야 하는 작업에 앞서,

안드로이드 스튜디오에서 다음과 같은 경고 메시지가 출력되었다.

We recommend using a newer Android Gradle plugin to use compileSdk = 34

This Android Gradle plugin (8.0.2) was tested up to compileSdk = 33.

You are strongly encouraged to update your project to use a newer
Android Gradle plugin that has been tested with compileSdk = 34.

If you are already using the latest version of the Android Gradle plugin,
you may need to wait until a newer version with support for compileSdk = 34 is available.

이 말은 즉, 특정 SDK의 API를 사용하려면 안드로이드 그레이들의 플러그인을 최신화하란 말이다.

내 경우의 상황을 인터넷 검색으로 알아본 결과,

스택 오버 플로우에서 어느 한 답변에 의하면 8.1.1 버전 이상으로 올리라고 하는데

아무리 업데이트를 확인해보아도 안드로이드 스튜디오에서는 8.0.2 버전이 최신이란다.

같은 오류 내용으로 포스팅한 바가 있지만,

이번엔 조금 더 자세한 원인과 해결방법을 알게 되어 이 내용을 새로이 공유하고자 글을 남긴다.

이전 글의 내용을 보고 싶다면 아래의 링크를 참고하자.

Android Studio Build Error) We recommend using a newer Android Gradle plugin to use compileSdk

원인

알고보니 안드로이드 스튜디오와 안드로이드 그레이들 플러그인이 각각 버전별로 호환성이 다르기 때문이다.

쉽게 말하면, 안드로이드 스튜디오 버전에 따라 지원되는 그레이들의 버전이 있다는 것이다.

안드로이드 스튜디오 페이지에서 확인한 내용에 따르면 다음과 같다.

* 여기서 AGP란, Android Gradle Plugin의 약자로, 흔히 알고 있는 그레이들을 의미한다.

Android 스튜디오 버전	필요한 AGP 버전
무당벌레 \| 2024년 2월 1일	3.2~8.7
코알라 기능 출시 \| 2024년 1월 2일	3.2~8.6
코알라 \| 2024년 1월 1일	3.2~8.5
해파리 \| 2023년 3월 1일	3.2~8.4
Iguana \| 2023.2.1	3.2~8.3
Hedgehog \| 2023.1.1	3.2-8.2
Giraffe \| 2022.3.1	3.2~8.1
Flamingo \| 2022.2.1	3.2~8.0

(출처 : 안드로이드 스튜디오 공식 레퍼런스 - 새로운 기능)

자신의 안드로이드 스튜디오 버전을 확인하는 방법은

안드로이드 스튜디오 메뉴에서 'Help - About' 를 차례로 눌러보자.

나 같은 경우에는 Android Studio Flaming였다.

페이지에서 안내한 내용 그대로 내 안드로이드 스튜디오는 최대 8.0까지만 지원하지 않으니

8.0.2 이후 업데이트가 없다고 나온 것이었다.

해결 방법

안드로이드 스튜디오에 호환되는 버전으로 업그레이드

compileSdk에 맞는 최소 AGP(Android Gradle Plugin) 버전을 사용하려면

안드로이드 스튜디오 버전 업그레이드를 통해 그레이들의 버전을 올려 해결할 수 있다.

안드로이드 스튜디오에서 'Help - Check for Updates'를 누르자.

만약 업데이트할 버전이 존재한다면 아래의 예시 이미지와 같이

오른쪽 하단에 업데이트할 버전이 있다고 작은 팝업이 출력된다.

'Update...'를 누르면 화면 정중앙에 업데이트 팝업이 다시 출력되는데,

'Download' 버튼을 누르면 안드로이드 스튜디오 다운로드 페이지로 이동된다.

새로운 버전의 Android Studio를 다운로드를 한 후 재설치를 진행하면 된다.

당연한 이야기이지만, 안드로이드 스튜디오를 재설치할 때에는

실행되어 있는 안드로이드 스튜디오는 종료한 뒤 재설치해주어야 한다.

그레이들 버전 업데이트

프로젝트에서 프로젝트를 담당하는 "build.gradle(Project: xxx)" 파일을 열자.

그러면 의존성을 주입하는 곳에 그레이들 버전을 입력하는 곳(com.android.tools.build:gradle)이 보일 것이다.

현재 요구하는 API 34의 최소 그레이들 버전은 8.1.1이므로, 나는 8.1.1을 해주었다.

물론 그 이상의 버전을 선택해도 된다.

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.1.1' // 8.0.2에서 8.1.1로 업데이트
        classpath 'com.google.gms:google-services:4.3.14'
    }
}

버전을 변경했으면 우측 상단의 'Sync Now'를 눌러 해당 프로젝트에 적용될 수 있도록 해준다.

Python Flask - Flask 서버에 무료 SSL 인증서 적용하는 방법 (Windows, win-acme, NginX)

luvris2 — Thu, 12 Sep 2024 00:45:45 +0900

무료 인증서를 발급 받기 위해 Let's Encrypt의 SSL 인증을 받아야 할 때,

보통 서버(Apache, NginX 등)를 이용하여 웹 루트를 정하고 인증을 받는 방식으로 진행한다.

특히 윈도우에서 win-acme 도구를 이용하여 무료 SSL 인증서 발급 시

보통 파일 방식으로 인증을 받는 식인데, 문제는 여기서 발생한다.

Flask의 경우에는 서버 자체에서 특정 URL의 경로를 미리 정의해주지 않으면 안된다는 것이다.

하지만 win-acme 도구는 사이트 인증 시 내가 지정한 웹 루트에

랜덤으로 주어진 코드가 적혀있는 파일이 생성되는데,

이런 동적인 상황에 생성되는 랜덤 주소 URL 링크를 미리 알 방법이 없다.

예를 들어, 내가 지정한 웹 루트에 '.well-known/acme-challenge/랜덤값' 이 주어지는데,

이 랜덤값을 미리 알 수 없으니 SSL 인증을 위해 해당 주소를 사전에 정의할 수 없다는 것이다.

이 글은,

1) 윈도우 운영체제에서

2) 엔진엑스를 이용하여

3) 파이썬 플라스크 서버를

4) win-acme 도구를 통해 네트워크 경로의 파일 방식으로

무료 SSL 인증서를 발급 받을 수 있도록 인증하는 방법에 대해 다룬다.

이 글은 Flask 서버에 한정되어 SSL 인증을 받을 수 있는 방법을 설명한다.

윈도우에서 무료 SSL 인증서를 발급받고자 한다면 아래의 글을 확인하자.

nginx - 윈도우에서 무료 SSL 발급 및 적용하기 (Let's Encript ACME For Windows)

Nginx 설정

우선 win-acme 도구를 통해 해당 경로의 파일을 생성할 수 있도록 엔진엑스를 설정해주자.

location 부분에 /.well-known/acme-challenge/ 경로 접근 시 생성될 디렉토리를 지정해준다.

플라스크 서버는 기본적으로 파일을 다루는 디렉토리의 기본 경로는 static이다.

때문에 가능하면 플라스크가 구동되고 있는 프로젝트 루트 디렉토리에서

하위 디렉토리인 'static'으로 SSL 인증을 받을 수 있도록 경로를 지정해주자.

내 경우엔 FlaskBlogServer 라는 프로젝트 디렉토리의 static 디렉토리를 지정해두었다.

그러면 SSL 인증 시 생성될 디렉토리 구조는

'C:\WorkSpace\FlaskBlogServer\static\.well-known\acme-challenge\파일이름'이 된다.

# 설정 예시
server {
    listen          80; # Python Flask Auto Posting Server
    server_name     post.eunbyeol.co.kr;
    return 301      https://$server_name$request_uri;

    location /.well-known/acme-challenge/ {
        root        C:/WorkSpace/FlaskBlogServer/static;
    }

Flask Routes 설정

가장 중요한 부분이다.

동적으로 생성되는 파일의 값을 허용하기 위해서는

요청되는 루트의 뒷 부분의 값을 문자열로 받아 처리할 수 있도록 해야 한다.

나는 여기서 경로의 마지막 부분의 값을 변수로 받아 생성된 파일을 다시 리턴할 수 있도록 하였다.

# 블루 프린트 등록
routesBp = Blueprint('routes', __name__, template_folder='../templates')

# SSL 인증을 받기 위한 경로 설정
@routesBp.route('/.well-known/acme-challenge/<path:filename>')
def serve_acme_challenge(filename):
    return send_from_directory('static/.well-known/acme-challenge', filename)

send_from_directory : 서버에서 특정 디렉토리 내에 있는 파일을 클라이언트로 전송할 때 사용하는 함수이다. 파일 다운로드 기능이나 동적으로 파일을 제공할 때 유용하게 사용할 수 있다.

이로써 SSL 인증을 받기 위한 Nginx와 Flask의 설정이 끝났다.

win-acme로 인증 받기

인증을 진행해보자.

win-acme를 실행하여 차례대로 아래의 과정을 진행한다.

Please choose from the menu:
- M: Create certificate (full options)
How shall we determine the domain(s) to include in the certificate?:
- 2: Manual input
Host:
- SSL 인증받을 본인 웹 사이트 주소 입력 (예시: post.eunbyeol.co.kr)
Friendly name '[Manual] post.eunbyeol.co.kr'. <Enter> to accept or type desired name:
- 그냥 Enter로 진행
Would you like to split this source into multiple certificates?:
- 1: Separate certificate for each domain (e.g. *.example.com)
How would you like prove ownership for the domain(s)?:
- 1: [http] Save verification files on (network) path
Path:
- Flask 프로젝트의 static 경로 입력 (예시: C:\WorkSpace\FlaskBlogServer\static)
Copy default web.config before validation? (y/n*)
- N
What kind of private key should be used for the certificate?:
- 2: RSA key
How would you like to store the certificate?:
- 2: PEM encoded files (Apache, nginx, etc.)
File path:
- SSL 인증서가 저장될 경로 입력 (예시: C:\dev\nginx-1.26.1\ssl)
Choose from the menu:
- 1: None
Would you like to store it in another way too?:
- 5: No (additional) store steps
Which installation step should run first?:
- 3: No (additional) installation steps

입력을 모두 마치면 인증이 진행되며, 지정한 경로에 .pem 파일이 생성된다.

생성된 파일로 SSL을 적용하면 된다.

NginX에 SSL 인증서 적용하기

http 주소를 https로 리다이렉트 하기

우선 https로 접속할 수 있게 http로 접속 시 리다이렉트를 해줄 수 있도록 하자.

확인해봐야할 부분은 'return 301'이다.

요청받은 주소를 https로 변경하여 접속할 수 있도록 해준다.

아래는 예시 코드이다.

server {
    listen          80; # Python Flask Auto Posting Server
    server_name     post.eunbyeol.co.kr;
    return 301      https://$server_name$request_uri; # https로 리다이렉트
}

https의 SSL 인증서 적용하기

위의 과정을 통해 발급 받은 pem 인증 파일을 Nginx에 등록해주자.

win-acme에서 지정한 SSL 파일 저장 경로에 존재하는 pem 파일을

아래의 예시를 보고 자신에게 맞게 변경하여 넣어주자.

server {
    listen          443 ssl;
    server_name     post.eunbyeol.co.kr;

    ssl_certificate C:/dev/nginx-1.26.1/ssl/post.eunbyeol.co.kr-crt.pem;
    ssl_certificate_key C:/dev/nginx-1.26.1/ssl/post.eunbyeol.co.kr-key.pem;
    ssl_trusted_certificate C:/dev/nginx-1.26.1/ssl/post.eunbyeol.co.kr-chain.pem;

    location / {
        proxy_pass  http://192.168.0.78:4002/;
    }
}

변경사항을 적용할 수 있도록 엔진엑스를 리로드해주고,

만약 플라스크 서버가 켜져있다면 서버 또한 재시작해준다.

그리고 웹 사이트에 접속하면 정상적으로 SSL이 적용되어

https로 페이지를 보여주는 것을 확인할 수 있다.

C# - 파일 처리 메모리 누수 트러블슈팅

luvris2 — Sun, 1 Sep 2024 02:04:00 +0900

막연하게 간단한 기능을 하는 프로그램을 제작할 때까지는 몰랐다.
그러나 대량의 파일을, 대량의 데이터를 다루고 처리해야하는 상황에서
하루가 지나도록, 아니 시간이 지나면 지날수록 작업 속도가 현저히 느려지는 현상이 발생하였다.
분명 테스트할 때는 이상 없었는데...
확인해보니 프로그램을 처음 실행했을 때의 메모리는 21메가를 차지하였지만,
하루가 지난 상태에서 메모리 사용률은 7기가에 임박했다.

"무엇이 문제일까?"

파일 디렉토리를 탐색하는 방법을 좀 더 효율적으로!

C#에서는 Directory 클래스를 통해 폴더를 다룰 수 있는데

Directory.GetFiles 메서드를 이용하여 폴더 내 파일 목록을 가져오도록 구현했다.

하지만 이는 잘못된 선택이였다.

Directory.GetFiles 메서드는 분명 사용하기 쉽지만

폴더 내 파일 개수가 많아질수록 성능이 크게 저하될 수 있다는 단점이 있다는 것을 알아냈다.

모든 파일 정보를 메모리에 한 번에 로드하기 때문에 대용량의 파일을 탐색할수록 로딩 시간이 매우 길어진다.

이를 해결하기 위해서 Directory.EnumerateFiles 메서드를 이용하면,

조금 더 효율적으로 파일 탐색 작업을 수행할 수 있다.

Directory.EnumerateFiles 메서드는 파일 목록 전체를 한 번에 메모리에 로드하는 대신,

파일을 하나씩 순차적으로 처리할 수 있는 IEnumerable<string> 객체를 반환한다.

즉, Directory.EnumerateFiles 메서드는 파일을 하나씩 처리하기 때문에

Directory.GetFiles 보다 메모리 사용량이 적고, 대량의 파일을 처리할 때 성능상 유리하다.

특히, 파일을 모두 사용하기 전에 작업을 완료하는 경우 (예: 특정 조건에 맞는 파일을 찾았을 때) 더욱 효율적이다.

Directory.GetFiles : 모든 파일을 한 번에 가져오기

Directory.GetFiles 메서드는 지정된 폴더 내의 모든 파일 목록을 string 배열 형태로 반환한다.

string[] allFiles = Directory.GetFiles(@"C:\MyFolder");

foreach (string file in allFiles)
{
    Console.WriteLine(file);
}

Directory.EnumerateFiles : 파일을 하나씩 순차적으로 처리

foreach (string file in Directory.EnumerateFiles(@"C:\MyFolder"))
{
    Console.WriteLine(file);
}

결론적으로 폴더 내 파일 개수가 적고 모든 파일 정보가 필요한 경우,

Directory.GetFiles 메서드를 사용하는 것이 간편하다.

테스트에는 문제가 없었던 이유 또한 위와 같다.

하지만 대량의 파일을 다루거나 파일을 하나씩 처리하면서 중간에 작업을 중단해야 하는 경우

Directory.EnumerateFiles 메서드를 사용하는 것이 성능 면에서 유리하다.

처리된 메모리 자원은 해제하도록! (GC)

작업 수행을 통해 즉시 처리되고 다시 사용되지 않을 자원은 메모리를 해제하여 공간을 확보한다.

단 한 번의 루프문은 작업량이 많아질수록 (내가 처한 상황은 루프문이 100만번 돌아야했다.)

저장되는 파일 구조의 정보가 계속해서 메모리를 할당하여 사용되는 메모리양이 증가한다.

이를 해결하기 위해서 수동으로 GC (가비지 컬렉터)를 호출하였다.

대량의 파일 관련 정보를 저장하는 루프문의 로직에서

batch의 작업 수를 체크하도록하는 역할을 갖는 변수를 두었다.

해당 변수를 통해 batch의 작업 할당량이 채워진 시점에 분기점을 나누고,

가비지 컬렉터로 메모리를 제거하여 자원을 확보하는 식으로 변경하였다.

GC.Collect(); // 가비지 컬렉션 강제 호출
GC.WaitForPendingFinalizers(); // 모든 종료 작업을 완료할 때까지 대기

가비지 컬렉션에 대한 내용은 아래의 링크에서 자세히 알아볼 수 있다.

> C# – 초보 개발자를 위한 가비지 컬렉션 기초

사용을 마친 객체의 자원은 바로바로 반납되도록! (Using, Dispose)

파일을 읽고 쓰는 과정에서 StreamReader 객체와 StreamWriter 객체가 빈번하게 호출되었다.

StreamReader/StreamWriter 객체는 사용이 끝난 후 해제해 주어야 한다.

StreamReader가 내부적으로 파일 스트림을 유지하고 있기 때문에

파일을 다 읽은 후에도 메모리를 점유할 수 있다.

당연하면서도 놓치기 쉬운 부분이였다.

확인해보니 코드 내에서는 따로 Dispose 메서드를 사용하지 않았었다.

이 문제를 해결하기 위해 using 블록을 사용하여 StreamReader가 사용된 후 자동으로 해제되도록 변경하였다.

void readFile(string path)
{
    using (StreamReader reader = new StreamReader(path))
    {
        string line, text = "";
        while ((line = reader.ReadLine()) != null)
        {
            text += line;
        }

        findText(path, text);
    }
}

using 블록을 왜 사용하는지, 어떤 점에 이득이 있는지에 대한 내용은 아래의 링크에서 자세히 알아볼 수 있다.

> C# – using 키워드, 왜 사용할까?

메모리 사용을 최소화하기 위한 문자열 최적화!

대량의 파일을 StreamReader 객체를 통해 반복적으로 파일의 읽어드리는 작업에서

읽어드린 파일의 내용을 저장할 string 객체 또한 지속적으로 내용이 변경되었다.

특히 string 객체의 쓰임새가 StreamReader에서 불러온 내용을

한 줄 한 줄 새로 내용을 추가하는 식의 코드인데,

string 객체는 불변 객체로, 추가된 내용을 임시 string 객체를 만들어 새로 저장하는 방식이다.

그에 반해 StringBuilder 객체는 가변 객체이므로 말 그대로 내용이 추가(수정)가 된다.

while 문을 통해 지속적으로 내용이 추가되는 코드에서

이 방식은 string 객체를 사용하면 결국 메모리를 많이 사용하게 된다.

기존

// 스트림 리더 객체 생성
StreamReader reader = new StreamReader(filePath);

// 파일 읽기
string line, text = "";
while ((line = reader.ReadLine()) != null)
{
	text += line;
}

// text 변수를 통해 처리 관련 로직 수행

수정

// 스트림 리더 객체 생성
using (StreamReader reader = new StreamReader(path))
{
    StringBuilder stringBuilder = new StringBuilder();
    
    // 파일 읽기
    string line;
    while ((line = reader.ReadLine()) != null)
    {
        stringBuilder.AppendLine(line);
    }
    
    // 처리 관련 로직 수행
}

문자열을 효율적으로 다루기 위해 StringBuilder에 대해 더 자세히 알아보고 싶다면 아래의 링크를 참고하자.

> C# – 문자열 다루기 String vs StringBuilder, 무엇을 사용해야 할까?

마치며

C#을 원하는 기능만을 구현하며 성능 퍼포먼스적으로 단 한 번도 제대로 생각해본 적이 없다.

또한, 이렇게 대량의 파일을 작업할 일도 없었다.

왜 사람들이 과부하에 대해 민감한지 잘 이해를 못했었는데, 이제서야 조금은 알게 된 것 같다.

씨샵 초보자에서, 이제 아주 조금은 더 아는 초보자가 되진 않았을까 생각해본다.

이렇게 성장해 나가는 거겠지 뭐.

C# SqlConnection Reference Error - 네임스페이스 'System.Data.SqlClient'에 형식 이름 'SqlConnection'이(가) 없습니다. / 서버에 연결했지만 로그인하는 동안 오류가 발생했습니다. 신뢰되지 않은 기관에서 인증서 체인을 발급했습니다.

luvris2 — Fri, 30 Aug 2024 10:47:44 +0900

데이터베이스 객체 사용 오류 발생

C# Winform 프로젝트에서 데이터베이스에 연결하려고 'SqlConnection' 객체를 사용하니 오류가 발생된다.

CS1069 네임스페이스 'System.Data.SqlClient'에 형식 이름 'SqlConnection'이(가) 없습니다.

using System.Data.SqlClient이 잘 명시되어 있음에도 오류가 출력된다.

분명 이전 프로젝트에서도 잘 사용했었는데 왜 그럴까?

원인

Microsoft는 최신 버전의 Visual Studio 및 .NET Core 5.0 이상에서 System.Data.SqlClient를 제거했다고 한다.

즉, Microsoft는 .NET Core 또는 .NET 5 이상에서는 System.Data.SqlClient가 기본적으로 포함되지 않는다.

여태 데이터베이스를 사용했던 프로젝트는 .NET Framework를 사용했던 것이다.

.NET Framework 프로젝트에서 System.Data.SqlClient는 기본적으로 포함되어 있다.

해결 방법

NuGet 패키지를 통해 참조를 추가하면 된다.

하지만 .NET Core/5+부터는 System.Data.SqlClient 대신

Microsoft.Data.SqlClient를 사용하는 것을 권장하고 있다.

이제 코드에 문제 없이 SqlConnection 객체가 잘 참조되고 있다.

만약 데이터베이스 연결 시도 시 아래와 같은 오류가 발생한다면,

연결 옵션에서 TrustServerCertificate를 True로 설정해주면 된다.

오류 내용 : 서버에 연결했지만 로그인하는 동안 오류가 발생했습니다. 신뢰되지 않은 기관에서 인증서 체인을 발급했습니다.

// 연결 설정에서 TrustServerCertificate=True 설정
string connectionString = "Server=_;Database=_;User Id=_;Password=_;TrustServerCertificate=True";

using (SqlConnection connection = new SqlConnection(connectionString))
{
	// 코드 작성
}

참고

stackoverflow -Unable to locate System.Data.SqlClient reference

압축 알고리즘 - PNG 파일, 왜 압축하면 더 커질까? 압축 시 용량이 늘어나는 이유

luvris2 — Thu, 22 Aug 2024 22:50:26 +0900

일반적으로 파일을 압축하면 용량이 줄어드는 것이 당연하다고 생각한다.
하지만 PNG 파일은 압축을 하면 오히려 용량이 늘어나는 경우가 많다.
왜 이런 현상이 발생하는 걸까?
이는 PNG 파일의 압축 방식과 일반적인 압축 프로그램의 작동 방식의 차이에서 기인한다.

PNG 파일의 특별한 성질

PNG 파일은 이미 최적화된 상태로 압축되어 저장되는 무손실 이미지 파일이다.
마치 공기를 뺀 풍선처럼 더 이상 압축할 공간이 없는 셈이다.
때문에 일반적인 압축 프로그램은,
이미 최적화된 PNG 파일에서 이러한 과정을 통해 얻을 수 있는 효과가 미미하다.

압축 프로그램의 한계

압축 프로그램은 PNG 파일의 특징을 완벽하게 이해하지 못하고
일반적인 파일 압축 방식을 적용하려고 한다.
이는 마치 이미 잘 정리된 서랍에 다시 한번 정리를 시도하는 것과 같다.
오히려 정리된 서랍을 더 어지럽힐 수 있다.

왜 용량이 늘어날까?

PNG 파일은 이미 최적화된 구조를 가지고 있다.
그렇기 때문에 일반적인 압축 프로그램이 추가로 압축할 수 있는 부분이 적다.
이는 즉, 추가로 하는 압축으로 얻는 이득이 적다는 것을 의미한다.
또한, 압축 프로그램은 압축된 파일의 정보를 저장하기 위해 메타데이터를 추가한다.
이로 인해 메타데이터가 추가되어 파일 크기가 오히려 늘어날 수 있다.

✅ 내용을 더 자세히 알아보고 싶다면?

이 글은 한 눈에 볼 수 있도록 요약되었다.
조금 더 해당 내용에 대해 자세히 알고 싶다면
아래의 링크를 참고하자.

CS – PNG 파일을 압축하면 용량이 오히려 늘어난다고?

C# - 파일을 열고 쓰는 방법에 대해 알아보자. (파일 열기,읽기,쓰기,저장)

luvris2 — Fri, 16 Aug 2024 10:46:35 +0900

반년만에 쓰는 씨샵 관련 글인 것 같다.

사실 해당 관련 내용은 이미 1년 전부터 글을 쓸까 말까 하다가

너무 귀찮아서 미루고 미루다가 이제서야 글을 쓴다.

씨샵 언어를 이용하여 파일을 열어서 읽고,

지정한 파일에 내가 작성한 내용을 쓰기(저장)를 하려면 어떻게 해야할까?

오늘은 씨샵에서 파일을 읽고 쓰는 방법에 대해 다뤄보자.

씨샵에서 파일을 읽고 쓰려면?

파일을 읽고 쓰려면 StreamReader와 StreamWriter가 필요하다.

StreamReader는 말 그대로 스트림 데이터를 읽을 수 있도록 해주는 클래스이고,

StreamWriter는 스트림 데이터를 쓸 수 있도록 해주는 클래스이다.

이는 즉, 파일을 쉽게 읽고 저장해주는 역할을 한다.

스트림 리더로 텍스트 파일 읽기 (파일 열기)

먼저, StreamReader 객체를 생성하고 읽을 파일의 경로를 지정해야 한다.
그리고 ReadLine() 메서드를 사용하여 파일에서 한 줄씩 읽어온다.
파일 읽기가 끝나면 Close() 메서드를 사용하여 StreamReader 객체를 닫는다.

ReadLine() 메서드
- 파일에서 한 줄을 읽어와 문자열로 반환하는 메서드
- 파일의 끝에 도달하면 null 값 반환

// 읽어올 파일 경로 지정
string filePath = "C:\\example.txt"; 

// 스트림 리더 객체 생성
StreamReader reader = new StreamReader(filePath);

// 파일 읽기
string line;
while ((line = reader.ReadLine()) != null)
{
    Console.WriteLine(line); // 읽은 내용 콘솔에 출력
}

// 스트림 리더 객체 닫기
reader.Close();

스트림 라이터로 텍스트 파일 쓰기

StreamReader는 파일 읽기 전용 도구이다.

텍스트 파일을 쓰려면 StreamWriter 클래스를 사용해야 한다.
StreamWriter 사용법은 StreamReader와 매우 유사하다.

먼저, StreamWriter 객체를 생성하고 쓸 파일의 경로를 지정한다.
* 두 번째 매개변수가 true일 경우에는 파일에 내용을 추가하며, false일 경우에는 파일의 내용을 덮어쓴다.

그리고 WriteLine() 메서드를 사용하여 파일에 텍스트를 저장한다.
파일 쓰기가 끝나면 Close() 메서드를 사용하여 StreamWriter 객체를 닫는다.

WriteLine() 메서드
- 파일에 텍스트를 쓰는 메서드
- 두 번째 매개변수를 지정할 경우, 파일이 없으면 새 파일을 만든다.

// 읽어올 파일 경로 지정
string filePath = "C:\\example.txt"; 

// 스트림 라이터 객체 생성, true 옵션은 파일에 내용을 추가하겠다는 의미
StreamWriter writer = new StreamWriter(filePath, true);

// 파일 쓰기
writer.WriteLine("새로운 내용 추가");

// 스트림 라이터 객체 닫기
writer.Close();

실제로 구현해보기

파일을 불러올 버튼과 파일을 저장할 버튼을 만들어서 코드를 구성해보자.

파일 읽기 (파일 불러오기)

// 파일 불러오기
private void btnRead_Click(object sender, EventArgs e)
{
    // 텍스트를 표시할 텍스트박스 초기화
    txtContent.Text = "";
    
    // 기본 경로 : 프로젝트 실행 경로를 기준으로 함
	string basePath = Environment.CurrentDirectory;

    // 불러올 파일 경로 확인
    string filePath = basePath + "\\" + txtOriginPath.Text;

    // 파일 경로 유효성 확인
    if (File.Exists(filePath))
    {
        using (StreamReader reader = new StreamReader(filePath))
        {
            // 파일 읽기
            string line;
            while ((line = reader.ReadLine()) != null)
            {
                txtContent.Text += line + Environment.NewLine; // 줄의 마지막이면 다음 줄로 이동
            }
        }
    }
}

파일 쓰기 (파일 저장하기)

// 파일 저장하기
private void btnSave_Click(object sender, EventArgs e)
{
    // 기본 경로 : 프로젝트 실행 경로를 기준으로 함
    string basePath = Environment.CurrentDirectory;

    // 저장할 파일 경로 확인
    string FilePath = basePath + "\\" + txtOriginPath.Text;

    // 저장할 파일 내용
    string content = txtContent.Text;

    // 파일 쓰기 : false (덮어쓰기)
    using (StreamWriter writer = new StreamWriter(FilePath, false))
    {
        writer.WriteLine(content);
    }
}

테스트

테스트에 사용될 파일

경로 : 프로젝트 실행 경로/test1.txt (\bin\Debug\net8.0-windows)
내용 : 테스트 파일입니다.

파일 불러오기 테스트

파일 경로 입력 : test1.txt
파일 불러오기 버튼을 클릭하여 텍스트 문서 파일이 불러와지는지 확인

파일 저장 후 다시 불러오기

파일 경로 입력 : test1.txt
파일 불러오기 버튼 클릭
파일의 내용이 불러와져 있는 텍스트 박스에 파일 내용 수정
파일 저장하기 버튼 클릭
파일 불러오기 버튼을 클릭하여 저장한 내용을 다시 불러오는지 확인

내용을 조금 더 자세히 알고 싶다면?

이 글은 파일을 열고 저장하는 방법에 대해서 다루었다.

세부적인 설명이 필요하거나,

추가로 파일을 복사 또는 이동하고, 삭제하는 방법을 자세히 알아보고 싶다면 아래의 링크를 참고하자.

C# Winform – 파일 다루고 처리하기 (파일 읽기/쓰기/이동/복사/삭제하기)

실제 테스트에서 쓰인 프로젝트는 깃허브에서 다운 받을 수 있다.

Github - C#_Winform_File_Management_Example

MySQL, Linux - 리눅스에서 MySQL 데이터베이스 포트 확인하기, 포트 번호 바꾸기

luvris2 — Thu, 18 Jul 2024 16:18:39 +0900

리눅스 우분투에서 RDBMS MySQL 데이터베이스의 포트를 변경하는 방법은 두가지가 있다.

리눅스 Ubuntu에서 MySQL 포트 확인하는 방법

1. MySQL의 설정파일 (mysql.conf)를 이용한 포트 확인

아래의 명령어를 입력하여 mysql 설정 파일에 접근한다.

sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf

내용 중 port = xxxx로 되어 있는 부분을 확인한다.

거기에 적혀있는 숫자가 MySQL의 포트 번호이다.

만약 주석이 되어 있으면 기본 포트 번호인 3306를 사용하고 있는 것이다.

리눅스에서 MySQL의 설정 파일을 이용하여 포트번호를 확인하는 예시

2. SQL 쿼리를 이용한 포트 확인

MySQL의 쿼리 내에서 글로벌 변수를 확인하여 포트의 번호를 알아내는 방법이 있다.

MySQL에 접속한다.

sudo mysql -u root -p

쿼리에 아래의 내용을 입력한다.

SHOW GLOBAL VARIABLES LIKE 'port';

Value 컬럼에 현재 사용중인 포트 번호를 확인할 수 있다.

MySQL 글로벌 변수를 이용하여 포트 번호를 확인하는 예시

리눅스에서 포트 번호를 바꾸는 방법은?

설정 파일에서 포트 번호를 확인하였지만,

해당 파일을 수정함으로써 포트 번호를 변경할 수 있다.

설정 파일에 접근해보자.

sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf

✅ 포트 번경하기

내용 중 port 부분을 찾아 커서를 이동한다.
앞에 주석(#)을 삭제한다.
port 값에 원하는 포트 번호를 입력한다.
저장한다. (Ctrl+X, y, Enter 차례로 입력)

리눅스에서 MySQL 설정파일인 mysqld.conf를 수정하여 포트를 변경하는 예시

변경한 포트로 적용하려면 MySQL의 서비스를 재시작해야한다.

sudo systemctl restart mysql

포트가 변경되었는지 글로번 변수를 이용하여 확인해보자.

포스팅에서는 예시를 위해 4306 포트로 변경하였다.

MySQL 쿼리를 이용하여 글로벌 변수인 포트의 번호를 확인하여 포트가 변경되었는지 확인하는 예시

정상적으로 MySQL 데이터베이스의 포트 번호가 변경된 것을 확인할 수 있다.

오라클 클라우드를 이용한 무료 워드프레스 웹 사이트 제작하기: 블로그 구축하기 A-Z 가이드

luvris2 — Mon, 15 Jul 2024 12:50:15 +0900

꿈꿔왔던 서비스, 나도 한 번 만들어보자!

개발자라면 누구나 한 번은 내가 만든 서비스가 수많은 사람들에게 보여주는 것을 상상해보았을 것이다.
하지만 막상 시작하려면 걱정부터 앞선다.
그 이유는 우선 서버 구축부터 관리, 비용까지 생각하면 막막하기 때문이다.
심지어 나의 경우에는 이미 AWS 1년 프리티어는 사용한 상황이고,
가벼운 토이 프로젝트를 AWS EC2 서비스를 유료로 사용하자니 돈이 부담되기도 하다.

집에 토이 프로젝트용 서버를 두긴하였으나,

특히 블로그 같은 웹 서버의 경우에는 집에서 돌리는 서버가 어떠한 사유로 인해 꺼지거나,

고장나는 경우에 대한 대비책이 전혀 없었기 때문에 클라우드로 눈길을 돌리게 되었다.

서버 구축에 많은 고민을 하던 중, 오라클 클라우드를 알게 되었다.

내 눈길을 사로 잡은 것은 두 가지였다.
첫 번째로는 "평생 무료",

두 번째로는 "인스턴스 2개 제공".

"평생 무료인 인스턴스가 무려 두 개나 제공된다고?"

무료로 사용할 수 있다는 말이 너무나 매력적으로 다가왔고,

오라클 클라우드를 이용하여 서버를 구축해보고자 한다.

그래서 이번 글은...

오라클 클라우드를 이용하여 웹 서버를 구축하고,
워드프레스를 설치하여 블로그 혹은 쇼핑몰 사이트를 만드는 방법에

대한 글을 시리즈로 나눠서 써볼까 한다.

워드프레스는 개인 홈페이지(블로그)나 상업용(쇼핑몰)을 구축하기 위해 사용하는 사람이 많기 때문에

이 글은 최대한 개발과는 거리가 먼 일반인을 기준으로 글을 쓰려 한다.

아래는 오라클 클라우드의 인스턴스에 워드프레스를 설치하여 무료로 웹 페이지를 구축한 사이트이다.

비용은 도메인 비용 외엔 1원도 들지 않았다.

> https://eunbyeol.co.kr/

은별 월드

프로그래밍과 이런 저런 이야기, 배우고 성장하기 위한 작은 공간

eunbyeol.co.kr

nginx - 윈도우용 nginx 설치 및 실행 방법, 명령어 사용법

luvris2 — Fri, 12 Jul 2024 00:05:09 +0900

Nginx란?

Nginx는 엔진엑스로 발음하며 경량, 고성능, 안정적으로 유명한 웹 서버이다.

웹 사이트, 웹 애플리케이션, API 등 여러 방면에 사용된다.

웹 서버
- 정적 파일 서비스: HTML, CSS, JavaScript 등의 파일을 클라이언트에 제공
- 높은 동시성 처리: 많은 연결을 효율적으로 처리
리버스 프록시
- 백엔드 서버 앞에서 요청을 분배하고 캐싱
- 로드 밸런싱: 여러 서버에 트래픽 분산
로드 밸런서
- 여러 서버 간 부하를 분산하여 시스템의 안정성 높임
HTTP 캐시
- 자주 요청되는 콘텐츠를 캐싱하여 응답 시간 단축
보안 기능
- SSL/TLS 지원: HTTPS 연결 처리
- DDoS 방어: 트래픽 제한 등의 기능 제공
가벼운 리소스 사용
- 적은 메모리와 CPU 사용으로 높은 성능 제공
모듈식 구조
- 다양한 모듈을 통해 기능 확장

Nginx는 이러한 특징으로 인해

웹 서비스, 마이크로서비스 아키텍처, CDN 등 다양한 환경에서 널리 사용되고 있다.

특히 Spring Boot 애플리케이션의 프론트엔드 서버로 자주 활용되어,

정적 파일 서비스와 로드 밸런싱을 담당하며 애플리케이션의 성능과 안정성을 향상시키는 역할을 한다.

윈도우 Nginx 설치하기

검색 엔진에서 nginx를 검색하여 해당 사이트에 들어가서 다운로드 받을 수 있다.

☞ nginx 다운로드 페이지로 이동하기

귀찮다면 아래의 링크를 눌러 다운로드를 진행하자.

☞ 윈도우용 nginx 1.26.1 (stable version) 다운로드 하기

다운로드가 끝나면 압축을 풀고, 놓고 싶은 위치에 저장해두면 된다.

저장해두는 위치는 Nginx의 root 경로가 되기 때문에 가능하면 삭제가 되지 않을 위치에 두는 것이 좋다.

나의 경우에는,

C드라이브에 dev라는 폴더를 만들어서 저장하였다.

이 폴더에는 오라클 클라이언트나 nginx 등 여러가지 개발 관련 프로그램을 저장해두고 사용하고 있다.

윈도우에서 Nginx 실행하기

윈도우에서 nginx를 제어하는 명령어이다.

명령 프롬프트에서 nginx 명령어를 사용하여 NGINX를 시작, 중지 및 제어할 수 있다.

NGINX 시작

nginx

NGINX 중지

nginx -s stop

NGINX 다시 로드

nginx -s reload

NGINX 구성 파일 테스트

nginx -t

Spring Boot - IntelliJ 없이 스프링 부트 프로젝트 실행하기 (JAR 파일 생성부터 빌드, 배포, 실행까지)

luvris2 — Thu, 11 Jul 2024 11:37:30 +0900

개요

스프링 부트 프로젝트를 진행중인데 인텔리제이를 사용하여 개발을 한다.

문제는 디버깅이 아닌 릴리즈 상태에서 스프링부트 프로젝트를 실행하기 위해서는

매번 인텔리제이를 키고 프로젝트를 실행하였었다.

이런 절차와 과정으로 서버를 사용하기엔 다소 무겁다고 느낌을 받았다.

IntelliJ 혹은 STS IDE 툴 없이 프로젝트를 실행하면 훨씬 가벼울텐데...

"더 가볍고 효율적인 방법으로 스프링 부트 프로젝트를 실행할 수는 없을까?"

이 글을 작성하게 된 계기이다.

이번 포스팅에서는 IDE 툴 없이 프로젝트를 실행할 수 있도록 JAR 파일로 만들어서 빌드 및 배포하는 방법을 다룬다.

왜 JAR 파일을 사용해야 하는지, 어떻게 빌드하고 배포하는지에 대해서도 알아보자.

스프링부트 프로젝트는 왜 JAR파일로 배포해할까?

JAR(Java ARchive) 파일은 자바 애플리케이션을 패키징하는 표준 방식이다.

물론 특성과 운영 환경에 따라 JAR 또는 WAR 중 선택할 수 있다.

JAR vs WAR 차이점은?

우선 JAR와 WAR의 차이부터 간단히 알아보자.

JAR 파일은 자체적으로 실행 가능한 자바 애플리케이션을 독립적으로 실행할 수 있다.

즉, 스프링 부트의 내장 웹 서버인 톰캣을 활용하여 독립적으로 실행될 수 있다는 것이다.

반면, WAR 파일은 기존 외부 웹 서버에 배포되어 웹 애플리케이션으로 실행된다.

독립적인 실행은 되지 않지만 웹 서버 설정에 따라 자유자재로 설정 변경이 가능하다는 장점이 있다.

스프링 부트는 자체 내장 서버가 포함되어 있는 프레임워크이다.

즉, 독립적으로 실행하는 것이 간편하고 효율적인 선택이 될 수 있다.

물론 무엇은 선택하든 괜찮다.

이는 개발자의 선호도, 서버 운영 상황에 따라 정석은 없다.

스프링 부트 문서에도 JAR 형식을 기준으로 기술되어 있고,

일반적으로 스프링 부트 프로젝트는 JAR 형식을 권장한다.

[참고] 스프링 부트 문서 - The Executable Jar Format

JAR 파일을 권장하는 이유

물론, 스프링 부트는 무조건 JAR 파일로 해야한다는 강제성은 없다.

하지만 JAR 파일을 이용할 경우 다음과 같은 이점을 가질 수 있다.

독립성

스프링 부트와 같이 내장 서버를 이용하여 독립적으로 실행할 수 있는 웹 애플리케이션이다.

효율성

WAR 파일에 비해 JAR 파일이 더 경량화가 가능하다.

편의성

필요한 모든 것을 하나의 파일에 담아 관리가 편리하다.

배포 용이성

JAR 파일 하나로 모든 필요한 라이브러리와 코드를 포함하며 간단하게 배포 할 수 있다.
하지만 상황에 따라 규모가 커질 경우에는 WAR 형식이 더 적합할 수 있다.

인텔리제이 없이 스프링 부트의 프로젝트를 실행하려면?

IDE 개발 툴 없이 스프링 부트의 프로젝트를 실행하려면 위에서 언급한 JAR 혹은 WAR 파일을 이용한다.

아래의 내용은 아래의 기준으로 설명하겠다.

Windows 운영체제 사용
JAR 파일로 패키징
Gradle 사용

gradlew를 사용한 JAR 파일 만드는 방법 (빌드 및 배포 파일 만들기)

1. 명령 프롬프트를 통해 프로젝트 루트 디렉토리로 이동한다.

# cd 프로젝트 디렉토리

cd C:\WorkSpace\SpringBoot\test-spring-boot-with-kotlin

2. 아래의 명령어를 이용하여 그레이들을 통해 빌드를 진행한다.

gradlew build

이미지와 같이 BUILD SUCCESSFUL 메시지가 출력되었다면 배포 파일이 생성된 것이다.

그레이들을 통한 배포 파일 생성 완료 예시 화면

배포 파일(JAR)는 프로젝트 디렉토리에서 "build - libs" 경로에 생성된다.

jar 파일 생성 확인 예시 화면

JAR 파일 실행하는 방법 (배포 파일 실행하기)

JAR 파일이 위치한 경로로 이동한다.

자신이 편한 위치에 파일을 이동시켜도 되지만 포스팅에서는 JAR 파일이 빌드된 위치에서 실행해보겠다.

# cd 프로젝트 디렉토리\build\libs\

cd C:\WorkSpace\SpringBoot\test-spring-boot-with-kotlin\build\libs\

java를 통해 jar 파일을 실행한다.

# java -jar 배포파일명

java -jar devbabys-0.0.1-SNAPSHOT.jar

스프링 부트의 문자가 뜬다면 실행이 된 것이다.

JAR 파일을 이용하여 스프링 부트 프로젝트를 실행한 화면 예시

위와 같이 하면, IDE 툴에서의 프로젝트 실행 없이 JAR 파일로만 프로젝트를 실행할 수 있다.

블로그 포스팅 자동 생성기, 글 작성 도우미로 보다 쉽게 글을 작성해보자!

luvris2 — Tue, 9 Jul 2024 16:50:52 +0900

개요

블로그에 글을 작성할 때마다 느끼는 고민이 많습니다.

어떤 말을 해야 할지, 개요와 서론을 어떻게 구성해야 할지, 내용은 어떻게 친근하게 다가가야할지 등으로요.

매번 글쓰기가 너무 익숙치가 않아서 이 참에 구글 Gemini API를 이용하여 포스팅 작성에 도움을 받고자 만들었습니다.

단순히 내가 사용하고자 만들었던 간단한 개인 프로젝트이지만 누군가에게도 도움이 되면 좋겠습니다.

사용 스킬

Language : Python
Framework : Flask
Web Crawler : Selenium
API : Google Gemini API
Hot Keyword Reference : Naver / Google
Host : https://post.eunbyeol.co.kr/

개발 이력

2024-06-25
- Gemini API 연동
- 프롬프트 엔지니어링
- 페이지 구축
2024-06-26
- 추천 키워드 시스템 추가 (주제별, 성별/연령별)
2024-06-28
- 추천 키워드 매일 자동 업데이트 기능 추가
2024-07-01
- 인기 키워드 페이지 UX 개선(마우스 오버된 키워드 표시, 클릭 시 입력 창에 키워드 자동 입력)
2024-07-02
- 추천 키워드 카테고리 추가 (일별)
2024-09-11
- 임시 도메인에서 서브 도메인으로 이전 https://babychat.xyz/post > https://post.eunbyeol.co.kr/

서버 닫아놨어요. 이제는 이용할 수 없습니다.

사용 방법

블로그 포스팅 생성기 예시 화면

1. 블로그 포스팅 내용 생성하기

(1) 포스팅할 주제나 키워드, 내용을 입력합니다.

(2) 포스팅 생성 버튼을 누르고 내용이 생성될 때 까지 기다립니다.

(3) 생성된 내용을 확인합니다.

2. 인기 키워드 보기

(1) 인기 키워드 보기 버튼을 누릅니다.

(2) 주제별, 성별/연령별/ 인별 키워드를 눌러 세부 카테고리를 선택합니다.

(3) 인기 키워드를 확인합니다.

+ 찾아보고 싶은 키워드를 클릭하면 포스팅 생성기의 주제 입력란에 자동으로 입력됩니다.

인기 키워드 페이지 예시 화면

3. 생성 결과 확인하기

키워드나 내용을 입력하여 생성된 내용입니다.

자세한 것은 아래의 예시 챕터 참조

블로그 자동 포스팅 생성기로 생성된 예시 화면

체험해보기

✨ 프로토타입 체험해보기 : https://post.eunbyeol.co.kr/

Blog Posting Writer

post.eunbyeol.co.kr

참고사항

* 현재 무료 API를 사용하기 때문에 일일 일정량 이상을 사용하면 사용이 제한되는 단점이 있습니다.

* 이미지는 미니피씨 사양의 한계로 생성되지 않고 텍스트만 제공됩니다.

* 프로토타입이기 때문에 오픈된 주소는 언제든 닫힐 수 있습니다.

* 개인 사용 용도이기 때문에 로직은 언제든 변경될 수 있습니다.

* 제작자도 블로그 작성에 참고, 도움이 될 수 있도록 생성된 포스팅에 대한 키워드는 기록됩니다.

* 전기세를 위해(..) 광고를 삽입하였습니다.

예시

아래의 글은 블로그 포스팅 자동 생성기를 활용하여 작성된 글입니다.

블로그 포스팅? 이제 AI가 대신 작성해 드립니다!

매일 글감 찾고, 자료 조사하고, 글 쓰느라 머리 아프시죠? 블로그 운영, 생각보다 손이 많이 가는 작업인데요, 이젠 블로그 포스팅 자동 생성기가 그 고민을 덜어드립니다!

(이미지: 바쁜 현대인이 노트북 앞에서 머리를 싸매고 있는 모습)

블로그 포스팅 자동 생성기, 넌 누구냐!

블로그 포스팅 자동 생성기는 인공지능 기술을 활용해 여러분이 원하는 주제의 블로그 글을 뚝딱 완성해주는 서비스입니다. 더 이상 키워드 조사, 자료 수집, 문장 구성에 시간을 쏟을 필요 없이, 여러분의 소중한 시간을 아낄 수 있습니다.

나만을 위한 블로그 포스팅, 이렇게 만들어 드립니다! ✍️

간단한 입력: 블로그 글에 담고 싶은 주제 또는 키워드를 입력해주세요. 예를 들어, "반려동물 산책 꿀팁" 또는 "최신 스마트폰 리뷰" 와 같이 원하는 주제를 자유롭게 입력하면 됩니다.
AI 마법 발동: 인공지능이 여러분이 입력한 주제를 분석하여 흥미로운 제목과 내용으로 구성된 블로그 포스팅 초안을 작성합니다.
나만의 글 완성: AI가 작성한 초안을 바탕으로 자유롭게 내용을 추가하거나 수정하여 나만의 개성이 담긴 블로그 포스팅을 완성할 수 있습니다.

(이미지: 사람이 블로그 포스팅 자동 생성기에 키워드를 입력하면, AI가 글을 작성하는 모습)

매일매일 새로운 아이디어, 인기 키워드 추천!

"어떤 주제로 글을 써야 할지 모르겠어요…" 고민하지 마세요! 블로그 포스팅 자동 생성기는 매일 오전 6시, 사용자들이 가장 많이 찾는 인기 키워드를 업데이트하여 새로운 글감을 제시합니다. 트렌드에 맞는 블로그 운영, 이제 어렵지 않습니다!

(이미지: "오늘의 인기 키워드" 라는 제목으로 여러 키워드들이 화면에 나타나는 모습)

블로그 포스팅 자동 생성기, 이런 분들에게 추천합니다!

바쁜 일상 속 블로그 운영에 어려움을 느끼는 분들
글쓰기에 자신이 없어 시작하기 망설여지는 분들
트렌드에 맞는 새로운 글감을 찾고 있는 분들

블로그 포스팅 자동 생성기와 함께라면 누구나 쉽고 빠르게, 퀄리티 높은 블로그 포스팅을 완성할 수 있습니다. 지금 바로 경험해 보세요!

MSSQL - SSMS에서 쿼리로 데이터베이스 용량 확인하는 방법

luvris2 — Mon, 8 Jul 2024 14:58:39 +0900

특정 데이터베이스 디스크 용량 확인 쿼리

데이터베이스 행 데이터 확인 쿼리

데이터베이스의 용량을 확인할 수 있는 쿼리이다.

DB_ID() 괄호 사이에는 데이터베이스의 이름을 넣어주면 된다.

✨ 메가 바이트 단위로 데이터베이스의 용량을 조회하는 쿼리

SELECT 
    name AS logical_name,
    size * 8.0 / 1024 AS size_in_mb
FROM 
    sys.master_files
WHERE 
    database_id = DB_ID('데이터베이스_이름');

용량이 클 경우, GB(기가바이트) 단위로 조회하고 싶으면 1024를 또 나누면 된다.

✨ 기가 바이트 단위로 데이터베이스의 용량을 조회하는 쿼리

SELECT 
    name AS logical_name,
    size * 8.0 / 1024 / 1024 AS size_in_gb
FROM 
    sys.master_files
WHERE 
    database_id = DB_ID('데이터베이스_이름');

데이터베이스 행 + 로그 데이터 확인 쿼리

현재 접속중인 데이터베이스의 로그 데이터까지 포함한 데이터베이스의 총 용량을 확인하는 쿼리이다.

SELECT 
    DB_NAME() AS DatabaseName,
    SUM(CASE WHEN type = 0 THEN size END) * 8 / 1024 AS DataFileSizeMB,
    SUM(CASE WHEN type = 1 THEN size END) * 8 / 1024 AS LogFileSizeMB
FROM sys.database_files

데이터베이스의 테이블별 용량 조회 쿼리

현재 접속중인 데이터베이스의 테이블별 용량을 조회하는 쿼리이다.

아래의 쿼리에서는 다음과 같은 디스크 용량 공간을 조회 가능하다.

단위는 메가 바이트를 기준으로 한다.

테이블에 할당된 총 공간
실제 데이터가 저장된 공간
할당되었지만 현재 사용되지 않는 공간

SELECT 
    t.name AS table_name,
    SUM(p.rows) AS row_count,
    SUM(a.total_pages) * 8 / 1024 AS total_space_mb,
    SUM(a.used_pages) * 8 / 1024 AS used_space_mb,
    (SUM(a.total_pages) - SUM(a.used_pages)) * 8 / 1024 AS unused_space_mb
FROM 
    sys.tables t
INNER JOIN 
    sys.indexes i ON t.object_id = i.object_id
INNER JOIN 
    sys.partitions p ON i.object_id = p.object_id AND i.index_id = p.index_id
INNER JOIN 
    sys.allocation_units a ON p.partition_id = a.container_id
GROUP BY 
    t.name
ORDER BY 
    total_space_mb DESC;

용량 확인 쿼리에서 8 혹은 8.0을 곱하는 이유는?

각 데이터베이스 파일은 크기를 페이지 단위로 나타낸다.

즉, 위의 쿼리들을 활용하여 시스템 뷰를 통해 반환되는 데이터베이스의 크기는 페이지 단위로 반환된다는 것이다.

실제로 반환되는 것은 디스크의 용량이 아닌 페이지 수이다.

SQL Server에서 각 페이지는 8KB를 차지한다.

따라서 페이지 수를 실제 크기로 변환하려면 8KB를 곱해야 한다.

메가 바이트, 기가 바이트를 구하려면 1024를 나누는 이유는?

컴퓨터는 2진수를 사용한다.

보통 우리에게 익숙한 1000 = 1k 와 같이,

컴퓨터에서는 2진수를 이용하여 가장 근사한 숫자인 1024를 사용한다.

즉, 1024KB는 1MB이기 때문에 메가 바이트, 기가 바이트를 구하려면 1024를 나누는 것이다.

일상 생활에서 우리가 사용하는 단위는 1000을 단위로 하기 때문에

실제 저장 매체의 디스크가 1테라라고 해도 실제 용량은 1테라가 아닌 것을 많이들 경험해 봤을 것이다.

같은 이치다.

참고

마이크로소프트 공식 사이트 - SQL Server 2022 - sys.master_files(Transact-SQL)

Excel - 엑셀에서 글자 가운데 선 줄긋기 (취소선 만들기)

luvris2 — Fri, 5 Jul 2024 17:39:49 +0900

아니, 자료 정리 다 했는데 뭘 수정해야 하지?

지우기엔 조금 아깝고...

엑셀에서 깔끔하게 취소선 긋는 방법 없을까?

엑셀 작업하다 보면 이런 생각, 한 번쯤 해보았을 것이다.

오늘 엑셀 취소선 긋기에 대해서 알아보자!

엑셀 가운데에 선으로 줄긋기 방법

취소선을 긋는 방법은 두 가지가 있다.

1) 셀 서식 메뉴를 이용한 취소선 긋기 및 추가 스타일 적용

1. 취소선을 적용할 셀이나 글자를 선택한다.

2. 마우스 오른쪽 버튼을 클릭하여 "셀 서식" 메뉴를 선택한다.

셀을 지정하여 셀 서식을 통해 취소선을 만드는 과정1

3. 셀 서식 창에서 "글꼴" 탭으로 이동하고,

효과 옵션에서 "취소선" 항목을 체크하고 확인을 누른다.

셀을 지정하여 셀 서식을 통해 취소선을 만드는 과정2

2) 단축키를 활용한 초간단 취소선 긋기

1. 취소선을 적용할 셀이나 글자를 선택한다.

2. 키보드에서 Ctrl + 5 (컨트롤+5) 키를 누른다.

✨ 위의 두 방법을 이용하면 아래와 같이 취소선을 만들 수 있다.

취소선이 그어진 화면

엑셀에는 업무 효율을 높여주는 다양한 단축키들이 많다.

자주 사용하는 기능들은 단축키를 활용하면 시간을 크게 절약할 수 있으니까

자신이 자주 쓸 것 같은 단축키를 꼭 외워두자!

nginx - 윈도우에서 무료 SSL 발급 및 적용하기 (Let's Encript ACME For Windows)

luvris2 — Thu, 4 Jul 2024 16:00:31 +0900

개요

프론트엔드의 서버가 API 서버의 http 문제로 인해 API 통신이 되질 않는다.

어차피 언젠가는 해야될 SSL 인증, 이번 기회에 해보자는 마음에 이 글을 작성하려 한다.

이 글은 NginX를 이용한 웹 서버에 SSL 인증서를 적용하는 방법을 다룬다.

✅ 같이 보면 좋을 글

SSL 인증서가 왜 필요할까?

SSL 인증서는 웹사이트와 사용자 사이에 오가는 정보를 암호화하여 안전하게 보호하는 역할을 한다.

쉽게 말해, 웹사이트와 사용자 사이에 보안 터널을 만들어주는 것이다.

이 터널을 통해 개인정보, 금융 정보 등 중요한 데이터가 보다 안전하게 전송될 수 있다.

또한, SSL 인증서를 적용하면 아래와 같은 이점이 발생한다.

방문자 입장에서는 SSL 인증서가 없는 웹 사이트는 브라우저 자체에서 경고 문구가 뜨기 때문에 불안할 수 있다. 보안이 강화된 웹사이트는 신뢰감을 줄 수 있다.
구글을 비롯한 검색 엔진들은 https 프로토콜을 사용하는 웹사이트를 더 높이 평가하기 때문에 SEO(검색 엔진 최적화) 효과를 누릴 수 있다.
SSL 인증서는 웹사이트 해킹 및 개인정보 유출을 예방하는 가장 기본적인 방법으로 사용된다. 때문에 웹 보안의 가장 첫 단계라고도 볼 수 있다.

SSL 인증 기관으로 Let's Encript를 선택한 이유

무엇보다 가장 큰 이유는 무료이기 때문이다.

Let's Encrypt는 비영리 기관에서 운영되기 때문에 누구나 무료로 SSL 인증서를 발급받을 수 있다.

또한 복잡한 절차 없이 자동화된 시스템을 통해 손쉽게 인증서를 발급받고 설치할 수 있다.

구글, 페이스북, 모질라 재단 등 글로벌 기업들이 후원하는

공인된 인증기관이라는 점에서도 신뢰성이 매우 믿음직하다고 볼 수 있는 기괸이다.

Let's Encript기관은 ACME 프로토콜을 사용하여

SSL 인증서의 유무 및 갱신 시기를 확인하고 자동으로 갱신하도록 해주고 있다.

✅ 여기서 ACME 프로토콜은 뭘까?

ACME (Automated Certificate Management Environment)의 준말이다.

도메인 유효성 검사, 설치 및 관리를 자동화하기위한 표준 프로토콜이다.

ACME 프로토콜은 인증서 자동화 솔루션으로 널리 사용되고 있다. (출처 SSL.com)

SSL 인증서 발급을 위한 도구 - Certbot

윈도우즈는 2024년 2월부터 지원을 중단했다.

검색하면 윈도우에서 Certbot을 사용하여 SSL을 발급받는 것이 많이 나오는데...

지금으로서는 사용이 어렵다고 보면 된다.

Certbot 개발자분의 말에 의하면 윈도우용은 지금도 사용은 가능하다고는 하는데,

자동 갱신은 안된다는 말을 하였다. 그리고 또한, 이 시점 이후로는 또 어떻게 될지 잘 모르겠다.

SSL 인증서 발급을 위한 도구 - win-acme

윈도우용으로 사용하기 위해서 win-acme툴을 선택하였다.

종류가 여러가지가 있던데 내 눈에는 딱 이게 눈에 들어오더라.

다른 종류를 사용해볼 의향이 있다면 letsencript 홈페이지에서 종류를 확인해보고 선택해서 진행해도 된다.

단, 이 글은 win-acme에 대한 설명만을 담고있기 때문에 다른 종류의 SSL 설치 방법은 이 글 내용과 해당하지 않는다.

종류 보기 : https://letsencrypt.org/docs/client-options/

윈도우즈용 ACME 다운로드

win-acme 사이트로 접속해서 다운로드를 받을 수 있다.

☞ win-acme 페이지 바로가기

Download - 버전 (recommended) 선택

SSL 인증서 발급받기

이 글은 윈도우 운영 체제를 기반으로 하였다.

또한 사용되는 툴은 win-acme를 사용하여 진행한다.

명령 프롬프트(CMD)를 열어 win-acme를 다운로드 받은 폴더로 경로를 이동한다.

wacs.exe 파일을 열면 정해진 순서에 맞게 진행하는 방법과

명령어를 통해 SSL 인증서를 발급받는 방법이 있다.

1) wacs.exe 파일을 실행하여 절차에 맞게 SSL 인증서를 발급받는 방법

win-acme 2.2.9.1701 버전을 기준으로 차례대로 아래와 같이 입력한다.

M: Create certificate (full options)
2: Manual input
Host: SSL 인증서를 적용할 도메인
1: Separate certificate for each domain (e.g. *.example.com)
1: [http] Save verification files on (network) path
Path: 웹 루트 디렉토리
N: Copy default web.config before validation? (y/n*) - no
2: RSA key
2: PEM encoded files (Apache, nginx, etc.)
1: None
5: No (additional) store steps
3: No (additional) installation steps

아래와 같이 뜨면 정상적으로 ssl 인증서 파일(pem)이 생성된 것이다.

wacs.exe 파일을 실행하여 절차에 맞게 SSL 인증서를 발급받는 결과 화면

2) 명령어를 통해 SSL 인증서를 발급받는 방법

아래의 명령어를 자신에 맞게 고친 후, 실행하면 된다.

wacs.exe --target manual --host HOSTNAME --webroot C:\dev\nginx-1.26.1\html --store pemfiles --pemfilespath C:\dev\nginx-1.26.1\ssl

--target manual : 수동으로 인증서를 발급받겠다는 의미이다.
--host HOSTNAME : 인증서를 발급받을 도메인 이름을 HOSTNAME 부분에 입력한다.
--webroot : ACME 챌린지 파일을 저장할 웹 서버의 루트 디렉토리로 지정한다. nginx의 경우 \html 경로로 설정해두면 된다.
--store pemfiles : 발급받을 인증서를 PEM 파일 형식으로 저장하겠다는 의미이다.
--pemfilepath PATH : PEM 파일을 저장할 경로 PATH를 지정한다. nginx 디렉토리 내의 편의상 SSL 폴더를 만들어 사용하는 것이 편하다.

실행을 하면 다음과 같이,

Certificate [Manual] HOSTNAME created라고 뜰 것이다.

그럼 정상적으로 SSL 인증서가 발급된 것이다.

명령어의 installation 부분은 내가 스크립트를 잘못 작성하였기 때문에 나타나는 에러로 무시해도 된다.

명령어를 통해 SSL 인증서를 발급받는 결과 화면

내가 지정한 경로에 PEM 파일이 생성된 것을 확인할 수 있다.

SSL 인증 파일이 pem 형식으로 생성된 것을 확인한 화면

nginx에 SSL 적용하기

nginx가 설치되어 있는 디렉토리에서 conf 폴더로 이동한다.

nginx.conf 파일을 열어 아래와 같이 server 블록을 수정 및 추가해준다.

기존 도메인 server 블록 수정하기

SSL을 적용하면 http의 요청을 https로 바꿔서 응답해주어야 한다.

listen의 80은 기본 http 요청의 기본 포트를 의미한다.

아래의 코드는 nginx의 nginx.conf 파일 내용 중,

80 포트로 들어오는 http 도메인의 주소를 https 주소로 리다이렉트 시키도록 하는 것이다.

중요한 것은 return 301 부분을 추가하고, location = / 부분은 삭제하면 된다.

server {
    listen          80; # Flask Babychat
    server_name     babychat.xyz;
    return 301      https://$server_name$request_uri; # 이 부분 추가
    
    # https로 리다이렉트하기 때문에 location / 부분은 삭제
    #location / {
    #    proxy_pass  http://192.168.0.78:3999;
    #}
}

SSL이 인증된 도메인 server 블록 추가하기

SSL 인증서를 포함하여 HTTPS 요청을 받을 수 있도록 해주는 코드이다.

443은 HTTPS 포트의 기본 포트를 의미한다.

ssl 인증을 적용하기 위해서는 win-acme 도구를 통해 생성된 pem 형식의 파일을 이용한다.

새롭게 생성된 pem 형식의 파일(key, crt, chain)을 상황에 맞게 자신의 서버 블록에 넣어주면 된다.

nginx의 버전 별로 설정 부분이 나뉘긴 하는데, 내용은 아래와 같다.

참고 : sslcert.co.kr - 'NginX SSL 인증서 설치/적용 가이드'

server {
    listen 443; (1.15 버젼 부터는 listen 443 ssl; 형식으로 변경됨)
    ssl on; (1.15 버젼 부터는 옵션 지원 종료)
    server_name www.sslcert.co.kr sslcert.co.kr; (지정한 서버인증서에 포함(지원)된 도메인)
    ssl_certificate_key /파일경로/www.sslcert.co.kr.key.pem; (개인키 파일 지정)
    ssl_certificate /파일경로/www.sslcert.co.kr.all.crt.pem; (서버인증서+체인+루트 통합 unified 파일 지정)
    ssl_protocols TLSv1.2; (서버 환경에 따라 선택적 적용)

    location /
    root path
    }
}

나의 경우, 현 시점의 nginx 안정 버전인 1.26.1 버전을 사용하여 아래와 같이 구상하였다.

server {
    listen          443 ssl;
    server_name     babychat.xyz;

    ssl_certificate C:/dev/nginx-1.26.1/ssl/babychat.xyz-crt.pem;
    ssl_certificate_key C:/dev/nginx-1.26.1/ssl/babychat.xyz-key.pem;
    ssl_trusted_certificate C:/dev/nginx-1.26.1/ssl/babychat.xyz-chain.pem;

    location / {
        proxy_pass  http://192.168.0.78:3999;
    }
}

80 포트와 443 포트에 대한 서버 블록 코드를 추가 및 수정이 완료되었다면,

이제 nginx를 실행해서 HTTPS로 정상적으로 접속이 되는지 확인해보면 된다.

# (nginx 설치 경로에서 명령 프롬프트 실행)

# nginx 실행
nginx

# 만약 nginx가 실행되어 있다면 재시작
nginx -s reload

HTTPS 적용 확인을 위한 사이트 접속

https로 정상적으로 잘 접속이 된다!

https로 접속해본 메인 화면

오류: 트러블 슈팅

win-acme 인증서 발급 중 오류1

Error: this may be because of insufficient rights or a non-Microsoft webserver using port 80
An error occured while commiting validation configuration

Authorizing using http-01 validation (SelfHosting)
 Unable to activate listener,
 this may be because of insufficient rights or a non-Microsoft webserver using port 80
 An error occured while commiting validation configuration:
 다른 프로세스가 파일을 사용 중이기 때문에 프로세스가 액세스 할 수 없습니다.
 An error occured during post-validation cleanup: Cannot access a disposed object.
Object name: 'System.Net.HttpListener'.
 Deactivating pending authorization
 Create certificate failed

80포트가 이미 사용중이기 때문에 win-acme(wacs)가 접근을 할 수 없다는 의미이다.

현재 80포트를 사용중인 서비스를 종료한다.

nginx를 사용중이라면 nginx가 80포트를 사용할 확률이 매우 높다.

nginx를 종료하고 다시 진행해보자.

win-acme 인증서 발급 중 오류2

Error: Timeout during connect (likely firewall problem)

Authorizing...
Authorizing using http-01 validation (SelfHosting)
Authorization result: invalid
{"type":"urn:ietf:params:acme:error:connection",
"detail":"xx.xxx.xxx.xxx: Fetching http://example.com/.well-known/acme-challenge/3ew_599WKxgh28LFE9hEPIM0rZ2tCg_cCo_gOcrYw8Q:
Timeout during connect (likely firewall problem)","status":400,"instance":null}
Deactivating pending authorization
Create certificate failed

시간이 초과될 때까지 접속을 하지 못했다는 소리다.

오류 내용에서 유추할 수 있듯이 80 포트가 닫혀있을 가능성이 있다.

인바운드로 들어오는 80포트를 사용할 수 있도록 열어주자.

인바운드 80 포트 사용 설정 예시 화면

시작 - 고급 보안이 포함된 Windows Defender 방화벽 실행
인바운드 규칙 - 이름(BranchCache 호스트 캐시 서버(HTTP-In)) 더블 클릭
이름과 설명 및 사용함 체크
확인

포트를 열고 다시 진행하면 된다.

HTTPS 접속 오류: 사이트에 연결할 수 없음

nginx에서 SSL 설정을 다했는데도 http는 정상적으로 처리되는데 https만 사이트 연결이 되지 않은 경우가 있다.

이럴 경우는 위와 같이 'win-acme 인증서 발급 중 오류2'와 같은 이유로 방화벽에서 차단되었을 수도 있지만,

인터넷 공유기 때문일 확률이 매우 높다.

인터넷 공유기는 자체 네트워크 설정을 지니는데,

포트 포워딩에서 허용되지 않는 포트는 접속을 차단하기 때문이다.

포트 포워딩을 허용해주려면 아래의 글을 참고하는 것이 좋다.

내용이 워낙 길어져서 링크로 대체하겠다. 외부에서 로컬 DB에 접속하는 방법을 다룬 글인데,

글 내용 중 외부에서 접속을 허용하기 위한 방법도 같이 기재되어 있다.

☞ MySQL - 외부에서 로컬 DB 서버 접속하기 (DB 서버 구축)

✅ 확인해야할 챕터

내부 포트 열기 (방화벽 해제)
외부 포트 허용하기 (포트 포워딩)

nginx - 서브 도메인 포트 라우팅 가이드 (For Windows)

luvris2 — Wed, 3 Jul 2024 15:10:57 +0900

개요, 웹 서버의 필요성

웹 서비스를 운영할 때, 비용상의 문제로 한 대의 컴퓨터에서 여러 개의 서버를 돌리는 경우가 있다.

특히나 개인용으로 만드는 대부분의 토이 프로젝트는 실질적인 상업 서비스를 하지 않기 때문에

여러 대의 컴퓨터를 두고 서버를 돌리기란 사실상 쉽지 않다.

또한, 한 장소에서의 공유기를 통한 경우에도 결국은 하나의 외부 아이피를 통하기 때문에

여러 개의 웹 서비스를 구축하려면 다음과 같은 문제가 발생한다.

도메인을 연결해야 하는데 80 / 8080 포트는 이미 메인 서비스를 제공한다.
다른 포트를 사용하려니 도메인 뒤에 포트를 입력해야 한다.
도메인 뒤에 포트를 입력하여 사용하려니 보기가 좋지 않다.

예시를 들어보자.

현재 서비스 중인 웹 서비스가 있다고 가정하자.

웹 서비스는 예를 들자면 abc.com을 기준으로, api 서버와 개발 서버를 따로 두고 개발해야 한다고 해보자.

api 서버 도메인 예시 : api.abc.com
개발 서버 도메인 예시 : dev.abc.com

위와 같이, 한 개의 메인 도메인(abc.com)을 기준으로 구분자를 넣으면 관리 차원에서 보기가 정말 용이하다.

하지만 실제 서버의 상황을 보면 abc.com:1111, abc.com:2222 이런식으로 진행된다.

그럼 위의 예시 도메인처럼 포트 번호가 필요 없이 깔끔하게 주소만 입력하게 하려면 어떻게 해야할까?

이럴 때 필요한 것이 서브 도메인과 포트 라우팅이다.

각 서비스마다 다른 포트를 사용해야 할 때,

서브 도메인을 통해 특정 포트로 간편하게 접속할 수 있도록 해야 한다.

그 것을 가능하게 해주는 것이 웹 서버로,

대표적으로 아파치(apache)와 엔진엑스(nginx)가 있다.

이 글에서는 nginx를 이용하여 한 개의 웹 서버에서 포트별로 분기를 처리 하고,

특정 포트로 접속할 수 있도록 설정하는 방법을 다룬다.

글을 읽기 전에...

이 글은 다음과 같은 상황을 위한 글이다.

여러 개의 웹 서비스를 운영하며 서브도메인 설정이 필요한 경우
윈도우 환경에 익숙하고 Nginx를 사용해보고 싶은 경우
복잡한 포트 번호 대신 깔끔한 서브도메인 주소로 서비스를 운영하고 싶은 경우
프론트엔드와 백엔드 서버를 분리하여 사용하고 싶은 경우

서브 도메인이 아직 없고 가비아를 사용하고 있다면 아래의 글을 참고하자.

가비아 - 서브 도메인 만들기 (DNS 설정하기, A 레코드 사용)

가비아 - 서브 도메인 만들기 (DNS 설정하기, A 레코드 사용)

개요도메인을 구입하여 블로그나 쇼핑몰, 특정 주제를 다루는 웹사이트를 운영하고 있을 때,또 다른 주제로 웹 사이트 확장과 함께 고민해야 할 부분이 있다.그것은 바로 서브 도메인이다. 내

luvris2.tistory.com

엔진엑스(NginX)란 무엇인가?

Nginx는 가볍고 빠른 성능으로 유명한 웹 서버이자,

컴퓨터 네트워크에서 클라이언트를 대신해서 한 대 이상의 서버로부터

자원을 추출하는 프록시 서버의 일종인 리버스 프록시 서버이다.

웹 서버, 프록시 서버, 로드 밸런서, 캐싱 서버 등

다양한 기능을 제공하는 강력하고 유연한 오픈 소스 웹 서버 소프트웨어로써,

다른 웹 서버에 비해 가볍고 자원을 적게 소모한다는 장점이 있다.

엔진엑스 설치하기

검색 엔진에서 nginx를 검색하여 해당 사이트에 들어가서 다운로드 받을 수 있다.

☞ nginx 다운로드 페이지로 이동하기

귀찮다면 아래의 링크를 눌러 다운로드를 진행하자.

☞ 윈도우용 nginx 1.26.1 (stable version) 다운로드 하기

다운로드가 끝나면 압축을 풀고, 놓고 싶은 위치에 저장해두면 된다.

엔진엑스의 작동 방식 이해하기

인터넷 검색 중, 아래의 그림이 너무 잘 표현된 것 같아서 인용하였다.

참고된 자료 URL : blog.kronis.dev - How to use Nginx to proxy your front end and back end

스프링 부트를 예로 아래의 그림을 봐보자.

브라우저에서 라우팅 처리는 스프링 부트 앱 자체에서 진행한다.

엔진엑스를 적용하기 전의 스프링 부트 앱 프로세스

그러나 우리가 원하는 것은 한 대의 컴퓨터에서 서브 도메인을 사용하기 위함으로써

메인 도메인과 서브 도메인을 구별하는 포트별 요청을 처리하여 각각의 메인/서브 서버에 요청을 전달해야 한다.

아래는 nginx가 적용된 프로세스이다.

엔진엑스를 적용한 백엔드, 프론트엔드 라우팅 프로세스

즉, nginx는 웹 서버로서 클라이언트의 요청을 받아 해당 요청을 처리할 서버를 선택하고,

선택된 서버로 요청을 전달해주는 역할을 한다.

그에 따라 포트별로 분기점을 나눠 각각의 서버에 전달하여 서브 도메인을 따로 운용할 수 있게 해준다.

이 글은 서브 도메인을 위한 라우팅이지만,

같은 의미로 백엔드와 프론트엔드를 한 대의 컴퓨터 서버에서 처리 할 수 있는 방법이기도 하다.

서브 도메인 포트 라우팅을 위한 엔진엑스 설정

포트 분기를 통해 서브 도메인 식별을 위한 엔진엑스의 설정을 하기 위해서는 사실 별로 어렵지 않다.

단지, 설정 파일의 값만 바꿔주면 된다.

엔진엑스를 다운 받은 폴더로 이동하자.

루트 디렉토리에서 conf 폴더 하위의 nginx.conf 파일을 연다.

밑으로 내리다보면 server 부분이 보일 것이다.

이 부분을에 대한 내용을 수정하면 된다.

서브 도메인을 추가할 때에는 server 파트를 한 번 더 기입한다.

예시

도메인
- 메인 도메인 : babychat.xyz
- 서브 도메인 : project1.babychat.xyz
서버 포트
- 메인 : localhost:3999
- 서브 : localhost:4001

# 메인 도메인
server {
    listen	80; # Nginx 기본 포트
    server_name  babychat.xyz;

    location / {
        proxy_pass http://192.168.0.78:3999;
    }
}

# 서브 도메인
server {
    listen       80;
    server_name  project1.babychat.xyz;

    location / {
        proxy_pass http://192.168.0.78:4001;
    }
}

엔진엑스 실행하기

엔진엑스를 다운 받은 폴더를 보면 nginx.exe 파일이 있다.

파일을 실행시키기만 하면 된다.

그러면 아무창도 뜨지 않게 되는데 백그라운드에서 실행되고 있다.

확인은 작업 관리자에서 할 수 있다.

작업 관리자에서 엔진엑스 실행을 확인한 화면

작업 관리자에서 확인된 프로세스는 작업 끝내기를 통해 쉽게 종료할 수 있다는 장점이 있다.

명령 프롬프트(CMD)를 통한 엔진엑스 실행 및 종료

좀 더 개발자스럽게 명령어를 통해 확인해보고 싶다면 아래의 명령어를 CMD에서 입력해보자.

nginx 실행

nginx경로/nginx.exe

nginx 실행 여부 확인

tasklist /FI "imagename eq nginx.exe"

nginx 실행 여부 확인 예시 화면

nginx 종료

taskkill /IM nginx.exe /F

nginx 종료 예시 화면

도메인 확인

메인 도메인은 3999번(Python Flask)으로 접속하고,

서브 도메인은 4001번(Kotlin SpringBoot)으로 접속하게끔 해두었다.

포트별로 분기 처리가 되어 각각 서버에 접속이 될까?

메인 도메인 확인

플라스크로 실행중인 포트로 정상적으로 라우팅되어 잘 표현된다.

메인 도메인 주소 확인 예시

서브 도메인 확인

서브 도메인을 넣어 접속해보았다.

스프링부트로 실행중인 포트로 정상적으로 라우팅되어 API 서버의 테스트 페이지가 잘 표현된다.

서브 도메인 주소 확인 예시

출처

가비아 - 서브 도메인 만들기 (DNS 설정하기, A 레코드 사용)

luvris2 — Wed, 3 Jul 2024 14:13:11 +0900

개요

도메인을 구입하여 블로그나 쇼핑몰, 특정 주제를 다루는 웹사이트를 운영하고 있을 때,

또 다른 주제로 웹 사이트 확장과 함께 고민해야 할 부분이 있다.

그것은 바로 서브 도메인이다.

내 경우를 예로 들어보자면...

대화를 나눌 수 있는 채팅 토이 프로젝트를 도메인을 구입하여 포트폴리오 겸 연결해 놓았다.

개발이 재미있어서 하는 목적도 있지만, 내가 만든 서비스가 비록 아무도 사용하지는 않더라도

어딘가에서 작동되고 있다는 것이 변태 같지만 뿌듯하기도 하니까 말이다.

그러나 다른 토이 프로젝트를 진행하려니 또다시 도메인을 사야 하는가에 대한 고민에 빠지곤 한다.

개발자들의 경우 간단한 테스트용 프로젝트를 웹 페이지에서 사용해야 한다면,

대개 귀찮으니 이미 존재하는 도메인 뒤의 path 부분에 추가적으로 url을 붙여 사용하는 경우가 많다.

나 또한 그렇다. 서브 도메인을 붙이려면 서버 설정, 포트 포워딩 등 건드려야 할 게 생각보다 복잡하기 때문이다.

이번에는 프로젝트 주제에 맞는 도메인이 아닌,

나 자체를 브랜딩 하기 위해 서브 도메인을 이용하여

체계적으로 주제에 맞는 프로젝트들을 하나씩 붙여나가는 방식으로 해보려 한다.

이번 포스팅에서는 국내에서 많이 사용되는 호스팅 업체 중 하나인 가비아를 예시로,

서브 도메인을 만드는 방법을 알아보도록 한다.

가비아 서브 도메인 만들기

가비아 홈페이지 로그인

가비아 웹 사이트에 접속하여 계정에 로그인한다.

☞ 가비아 홈페이지 바로가기

DNS 관리 페이지로 이동하기

로그인이 되면 오른쪽 상단의 My가비아 버튼으로 마우스를 이동하고

나타나는 하위 메뉴 중 서비스 조회의 서비스 관리를 클릭한다.

서비스 관리 페이지 이동 경로 설명 화면

서비스 관리 페이지에서 DNS 관리툴을 클릭한다.

DNS 관리툴 페이지 이동 경로 설명 화면

서브 도메인 만들기

서브 도메인을 만들 도메인 체크(선택)하고, DNS 설정 버튼을 누른다.

DNS 설정을 위한 도메인 선택 예시 화면

서브 도메인으로 사용할 주소를 설정한다.

예를 들어서 babychat.xyz가 메인 도메인이고,

앞에 project1이라는 서브 도메인을 붙여서 project1.babychat.xyz를 사용하려 한다면

하단의 레코드 추가 버튼을 누른 후, 아래와 같이 입력한다.

레코드 타입 : A
호스트 : project1
값/위치 : 서버가 돌아가고 있는 외부 IP 주소

상태 탭에서 확인을 누른 후, 저장을 누르면 된다.

'세팅이 완료되었다'는 알림 문구가 출력되면 서브 도메인이 생성된 것이다.

서브 도메인 DNS 설정 예시 화면

여기서 잠깐!

서브 도메인 설정 시, 레코드 타입이 A 또는 CNAME 둘 중 무엇을 선택해야 할지 모르겠다 싶으면,

차이점을 이해하고 자신의 상황에 맞는 타입을 선택하도록 하자.

A
- 도메인 주소와 서버의 주소를 IPv4 주소로 직접 매핑하는 방식이다.
- 호스트의 값/위치가 아이피 주소일 경우 사용한다.
- 프로그램이 도메인 이름을 통해 웹 서버의 IP 주소를 찾기 위해 사용한다.
- 예시 : example.com A 192.168.0.1
CNAME
- 도메인의 별명(별칭)을 다른 도메인 이름으로 매핑하는 방식이다.
- 여러 도메인이 같은 IP 주소를 가리킬 때 사용한다.
- 즉, 다른 주소를 입력해도 지정한 주소로 접속되도록 하는 것을 의미한다.
- 예시 : www.example.com CNAME example.com

서브 도메인 확인해보기

확인하기 전에!

위의 작업은 가비아 자체에서 서브 도메인을 생성해줬을 뿐,

새로운 서버를 서브 도메인으로 이용하길 원한다면

지정한 서버에서 서브 도메인의 요청을 받아 처리하고,

특정 기능을 수행할 수 있도록 하는 추가 설정을 필요로 한다.

nginx를 이용한 포트 분기 처리 설정을 하고 싶다면 아래의 글을 참고하자.

☞ nginx - 서브 도메인 포트 라우팅 가이드 (For Windows)

메인 도메인

접속 URL : babychat.xyz
Flask로 만든 채팅 서버(포트번호 5000)

메인 도메인 주소 확인 예시

서브 도메인

접속 URL : project1.babychat.xyz
Spring Boot로 만든 API 테스트 서버(포트번호 5001)

서브 도메인 주소 확인 예시

JS - 마크다운 문법 html 웹 페이지와 호환하기 (마크다운 html 변환, markdown to html)

luvris2 — Mon, 1 Jul 2024 12:26:03 +0900

개요

마크다운 문법으로 구성된 문서를 HTML에 표시하고 싶을 때 어떻게 해야할까?

직접 구현하는 것도 좋지만, 보편적으로 이미 만들어져있는 것을 사용하는 것이 생산성면에서 훨씬 이득이다.

보편적으로 사용되는 Markdown > HTML로 변환하는 라이브러리는 Marked를 이용한다.

이번 포스팅에서는 Marked 라이브러리를 이용하여 Markdown 형식의 문서를 HTML 로 변환하는 방법에 대해 가볍게 다뤄본다. 단, 단순히 파싱만 하는 과정을 소개하며 자세한 옵션에 대한 처리는 다루지 않는다.

(글을 쓰는 목적은 단순히 마크다운의 문서를 웹 페이지에 표시하기 위함이기 때문이다.)

Marked 라이브러리란?

Marked는 JavaScript 기반의 Markdown 파서(parser)이다.

이 라이브러리는 Markdown 형식의 텍스트를 HTML로 변환하는 데 사용되도록 설계되었다.

Markdown은 문서를 작성할 때 간단한 텍스트 기반의 형식으로,

GitHub, Reddit, 블로그, 문서 작성 등에 널리 사용된다.

마크다운의 문법을 HTML로 변환하기 위해서는 parse() 메소드를 이용하면 된다.

marked.parse(변환할 마크다운 문법 내용);

사용 예제 (Sample)

라이브러리 호출

Marked 라이브러리를 사용하기 위해 해당 라이브러리를 호출하여야 한다.

Marked 공식 홈페이지에서 제공하는 CND 주소는 다음과 같다.

<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>

마크다운 예시 내용

마크다운으로 구성된 내용이 다음과 같이 있다고 해보자.

# 마크다운 헤더1
**마크다운 문법**을 **HTML**로 변환하는 샘플 페이지
* JavaScript를 통해 쉽게 사용할 수 있다.

# : 헤더를 나타낸다. HTML에서는 <H1>을 의미한다.
** 글자 ** : 글자를 굵게하는 효과를 지닌다. HTML에서는 <B>를 의미한다.
* : 리스트의 목록을 나타낸다. HTML에서는 <UL>, <LI>를 의미한다.

샘플 HTML 페이지

위에서의 마크다운 문법의 내용을 이해를 돕기 위해 자바스크립트 변수로 저장하고,

marked.parse() 메서드를 통해 HTML로 변환해본다.

<!doctype html>
<html>
<head>
  <meta charset="utf-8"/>
  <title>Marked in the browser</title>
</head>
<body>
  <div id="content"></div>
  <!-- Marked 라이브러리 -->
  <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
  <script>
  	// 마크다운 문법을 변수로 저장
    let title = "# 마크다운 헤더1\n\n";
    let summary = "**마크다운 문법**을 **HTML**로 변환하는 샘플 페이지\n";
    let content = "* JavaScript를 통해 쉽게 사용할 수 있다.";

	// div 요소에 마크다운 문법을 HTML로 변환하여 표시
    let element = document.getElementById('content');
    element.innerHTML = marked.parse(title+summary+content);
  </script>
</body>
  <div id="content"></div>
</html>

샘플 페이지 브라우저 실행 화면

아래와 같이 보이기는 정상적으로 보인다.

HTML로 정상적으로 변환이 되었을까?

브라우저에서 샘플 페이지를 확인하여 마크다운 문법이 HTML로 파싱되었는지 확인한 화면

개발자도구에서 확인해보았다.

태그가 정상적으로 변환되어 구조를 이루는 것을 확인해볼 수 있다.

HTML로 파싱된 태그를 개발자 도구로 확인한 화면

참고

Marked Documentation - Getting Started - Installation

JS - iframe 페이지에서 부모 페이지 요소 제어하기, 샘플 포함

luvris2 — Sat, 29 Jun 2024 00:30:32 +0900

개요

iframe에서 부모 페이지의 요소를 제어해야 할 때가 있다.

내 상황으로 예를 들자면, iframe 페이지에서 선택한 값을 부모 페이지로 넘겨주고 싶다.

보통 다른 페이지간 데이터 전달은 URL 주소 뒤에 물음표(?) 기호를 이용하는 쿼리 스트링을 사용하지만,

페이지 내에 구성되어 있는 iframe은 조금 경우가 다르다.

방법

요소를 선택하는 것은 기본적으로 document.getElementId를 사용한다.

여기서 부모 요소를 의미하는 window.parent 키워드를 추가적으로 이용하면 된다.

window.parent:
- window.parent는 현재 iframe의 부모 창을 참조하는 것을 의미한다.
- iframe 내부에서 실행될 때 window.parent를 통해 부모 문서의 window 객체에 접근할 수 있다.
  * 윈도우 객체는 브라우저 창을 나타내는 전역 개체를 의미한다.
document:
- document 객체는 HTML 문서 전체를 나타내며, DOM(Document Object Model)의 루트 노드를 의미한다.
- 즉, DOM을 접근하고 다룬다는 것은 document 객체를 이용한다는 것과 같은 표현이다.
getElementById:
- 주어진 ID 값을 가진 요소를 선택하는 메서드이다.
- 만약 일치하는 요소가 없으면 null을 반환한다.

확인을 위한 테스트 페이지 구성

부모 페이지와 iframe 페이지를 간단히 구성해보자.

부모 페이지

iframe을 구성할 요소와 값을 넘겨 받아 출력할 textarea 요소, 단 두 개로 구성한다.

<!-- main.html -->

<!DOCTYPE html>
<html lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <!-- iframe 표시 영역 -->
    <div name="iframeContainer">
        <iframe src="iframe.html"></iframe>
    </div>
    <!-- iframe의 값을 넘겨 받은 값을 보여줄 영역 -->
    <div name="textContainer">
        <textarea id="textField" cols="45"></textarea>
    </div>
</body>
</html>

아이프레임 페이지

단순히 값을 넘길 버튼 하나로만 구성한다.

단, 자바스크립트를 이용하여 버튼 클릭 시, 해당 값을 부모 페이지로 넘겨주는 기능을 추가 구현한다.

자바스크립트 함수명 : sendParent

<!-- iframe.html -->

<!DOCTYPE html>
<html lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <!-- 함수 실행을 위한 자바스크립트 파일 -->
    <script src="iframe.js">
</head>
<body>
    <button id="iframeContent" onclick="sendParent(this)">이 데이터를 부모 페이지의 요소로 전달해보자.</button>
</body>
</html>

요소의 값을 부모 요소에게로 전달해주는 역할을 하는 함수

// iframe.js

function sendParent(element) {
    parentElement = window.parent.document.getElementById("textField");
    parentElement.textContent = element.textContent;
}

확인

테스트 파일을 확인해보기 전에...

이 페이지를 만약 로컬에서 html 파일로 만들고 브라우저에서 간단히 확인하려는 사람이 있다면 멈추자.

이는 브라우저의 동일 출처 정책을 위반하여 정상적인 기능 수행을 하지 못한다.

다음과 같은 에러가 출력될 것이다.

Uncaught DOMException:
Failed to read a named property 'document' from 'Window':
Blocked a frame with origin "null" from accessing a cross-origin frame.

로컬 html 파일을 브라우저에서 실행한 후 기능을 수행하면 위와 같은 에러가 발생한다.

때문에 이를 확인하기 위해서는 서버를 이용하여 확인해보아야 한다.

자신이 사용할 수 있는 로컬 서버를 구축해서 위의 테스트 코드를 확인해보아야 한다.

서버의 경우 Node, Spring 등 여러가지가 있으므로 자신이 편한 것으로 사용하면된다.

나같은 경우는 Flask를 이용하여 간단히 확인해보았다.

아이프레임의 버튼 클릭 전의 화면

버튼은 iframe 페이지 내, textarea는 부모 페이지에 위치해있다.

아이프레임의 버튼 클릭 후의 화면

부모 페이지의 textarea 요소에 전달한 글자가 정상적으로 표현되는 것을 확인할 수 있다.

Windows - 매일 혹은 주기적으로 자동 실행되는 작업 스케줄러를 구성해보자 (스케줄 자동화)

luvris2 — Fri, 28 Jun 2024 11:47:17 +0900

개요

매일매일 혹은 주기마다 특정 작업을 수행하도록 해야할 때가 있다.

내가 지금 하고 있는 토이 프로젝트에서는,

블로그 내용을 자동으로 생성해주고 포스팅 주제를 정하기 쉽도록 인기 키워드를 보여주려 한다.

때문에 매일매일 참고될만한 인기 키워드는 주기적으로 업데이트되야 한다.

이럴 때, 내가 특정 시간에 맞춰 일일이 인기 키워드 업데이트를 진행시켜주는 것보다는,

자동으로 특정 시간에 알아서 척척 업데이트를 해주는 것이

훨씬 안정적이고 생산성이 좋다는 것은 누구나가 다 알고 있는 사실이다.

이번 포스팅에서는 윈도우즈의 작업 스케줄러를 이용하여

스케줄에 맞게 작업을 자동으로 수행하도록 하는 방법에 대해 알아본다.

작업 스케줄러 실행하기

작업 스케줄러 실행 예시 화면

윈도우 키를 누르고 "작업 스케줄러"를 검색한다.

검색 결과에 작업 스케줄러 프로그램을 클릭하여 실행한다.

작업 스케줄러의 스케줄 설정하기

상단 메뉴의 동작 탭을 눌러 작업 만들기를 클릭한다.

스케줄러 추가하는 예시 화면1

새 작업 만들기 팝업이 출력된다.

일반 탭에서 스케줄러의 이름과 설명을 입력한다.

이름과 설명은 자신이 구별할 수 있는 식별자이므로 편한대로 입력하자.

만약 작업 스케줄러의 작업이 관리자 권한이 필요한 경우는 '가장 높은 수준의 권한으로 실행' 옵션을 선택하면 된다.

스케줄러 추가 시 일반 설정 예시

트리거 탭에서 새로 만들기 버튼을 클릭한다.

트리거는 어떠한 조건에 의해 스케줄러가 실행될지를 설정하는 기능을 한다.

스케줄러 추가 시 트리거 설정 예시

트리거 편집 팝업이 출력된다.

여기서 자신의 상황에 맞게 스케줄러의 일정을 설정해주면 된다.

나같은 경우는 하루에 한 번씩 매일매일 실행하도록 설정하였다.

아래 첨부된 이미지 화면에서의 예시는 1분 뒤 자동으로 설정되게끔 트리거를 설정한 예시 화면이다.

즉, 1분 뒤 작업 스케줄러의 트리거로 인해 설정한 작업 스케줄러가 실행 될 것이라는 것을 의미한다.

반드시 하단 고급 설정의 '사용' 메뉴가 체크 되어 있어야만 트리거가 작동하므로 주의하자.

트리거 편집 설정 예시 화면

트리거 편집을 마치고 확인 버튼을 누르면,

트리거 탭에 내가 새로 추가한 트리거가 추가되었음을 확인할 수 있다.

트리거 추가 확인 예시 화면

이제 동작 탭으로 이동해보자.

동작 탭에서는 내가 스케줄러에서 트리거에 의해 무엇을 수행할지를 설정하는 곳이다.

새로 만들기를 눌러 동작을 만들어보자.

스케줄러 추가 시 동작 설정 예시

새 동작 만들기 팝업이 출력될 것이다.

동작은 무엇을 동작할지를 설정하는 것이고,

프로그램/스크립트는 어떤 프로그램 혹은 스크립트를 실행할지를 설정하는 것이다.

나 같은 경우, 데이터를 매일 자동으로 업데이트하도록 프로그래밍 코드를 만들어놓았다.

그래서 매일 자동으로 업데이트 하려면 해당 소스 코드를 실행하도록 해야 한다.

그러기 위해 bat 확장자 파일을 이용하였으나,

이 부분은 사용자의 요구사항과 어떤 프로그램을 실행할지는 본인 마음이다.

새 동작 만들기 설정 예시

확인을 눌러 조건 탭으로 이동하자.

조건 탭에서는 컴퓨터의 환경 조건을 설정하는 곳이다.

컴퓨터의 전원 유무 및 네크워트 연결 유무 등을 설정한다.

이 설정은 모두가 같을 수 없으므로 본인에 맞게 설정하자.

나는 전원이 켜져 있는 경우에 작업을 시작하도록 설정하였다.

스케줄러 추가 시 조건 설정 예시

설정 탭으로 이동해보자.

설정 탭에서 또한 자신 요구 사항에 맞게 설정한다.

추천하는 메뉴는 '예약된 시작 시간을 놓친 경우 가능한 대로 빨리 작업 시작'이다.

만약을 대비해서 작업 스케줄러가 실행하지 못했다면, 그에 대한 작업은 해야하니 말이다.

스케줄러 추가 시 설정 탭 예시

확인을 눌러 새 작업 만들기 작업을 마치면 설정한 작업 스케줄러가 추가되었다.

작업 스케줄러 생성 확인 예시

작업 스케줄러 수행 여부 확인

이번엔 설정한 작업 스케줄러가 진짜로 수행되는지 확인해보자.

포스팅에서는 1분 뒤, 작업 스케줄로에 의해 자동으로 일간 핫 키워드를 수집하고,

수집된 키워드를 데이터베이스에 저장하며 내가 만든 웹 페이지에 뿌려주도록 프로그래밍 해놨다.

우선 스케줄러에 의해 수집한 데이터가 정상적으로 생성되었는지 확인해보자.

(스케줄러 수행 내용 중에는 프로그래밍 코드에 의해 파일을 생성하도록 되어 있다.)

수집한 데이터가 파일로 저장되어 있는 것을 보니 정상적으로 스케줄러가 실행 된 것 같다.

웹 사이트에 접속하여 해당 내용이 반영되었는지도 확인해보았다.

이상없이 작업 스케줄러가 실행된 것을 볼 수 있다.

Python - 파일 입출력 관련 에러 , 'cp949' codec can't decode byte 0x84 in position 10: illegal multibyte sequence

luvris2 — Thu, 27 Jun 2024 12:32:37 +0900

오류 발생

파이썬에서 데이터를 파일로 처리하는 과정에서 다음과 같은 오류가 발생하였다.

오류 발생 예시 이미지

file read/write error :
'cp949' codec can't decode byte 0x84 in position 10: illegal multibyte sequence

소스코드는 다음과 같다.

try :
    with open(filepath, 'r') as f:
        read_data = f.read()
        return read_data
except Exception as e :
    return "file read/write error : " + str(e)

즉, 파일을 읽어오는 과정에서 오류가 발생했다는 것이다.

원인 파악

오류가 무엇을 의미하는지는 이전에 MySQL때 같은 경험이 있어서 대략 짐작은 간다.

MySQL CSV Import Error) Unhandled exception: 'cp949' codec can't decode byte : illegal multibyte sequence

오류 원인은 한글이 포함되었기 때문이다.

한글이 포함된 파일은 대개 cp949 형태의 인코딩 형식으로 저장된다.

하지만 이를 파이썬에서 파일을 읽어올 때,

파일의 인코딩 형식을 맞춰주지 않으면 읽을 수 없기 때문에 위와 같은 오류가 발생하는 것이다.

해결 방법

방법은 너무나도 간단하다.

파일을 읽고 쓰는 로직에서 인코딩 타입만 지정해주면 된다.

with open(filepath, 'r', encoding='utf-8') as f:
	# code

encoding = 'utf-8'은 한글이 지원되는 인코딩 형식을 사용하겠다는 말과 비슷하다.

내가 오류가 난 코드를 기준으로 수정을 하면 다음과 같다.

try :
    with open(filepath, 'r', encoding='utf-8') as f:
        read_data = f.read()
        return read_data
except Exception as e :
    return "file read/write error : " + str(e)

Spring Boot JPA - 페이지 1부터 시작하도록 설정하기, Pageable 페이징 처리 (Kotlin)

luvris2 — Tue, 18 Jun 2024 00:05:01 +0900

Pageable 이란?

Pageable은 Spring Data JPA에서 제공하는 인터페이스로,

페이지 정보(페이지 번호, 크기, 정렬 기준 등)를 캡슐화 하는 데 사용된다.

이를 통해 대규모 데이터를 페이징하여 효율적으로 처리 및 관리할 수 있다.

즉, 페이징 처리를 Pageable 인터페이스를 통해 쉽게 구현 가능하다.

PageNumber : 가져오려는 페이지의 번호, 기본적으로 0부터 시작한다.
PageSize : 한 페이지에 포함될 데이터의 개수를 의미한다. 기본 개수는 2000개이다.
Sort : 결과를 정렬하는 기준을 의미한다. 정렬 기준을 명시하지 않으면 정렬을 하지 않고, 데이터베이스에 가져온 순서대로 결과를 반환한다.

Pageable의 페이지를 1부터 시작하게 하려면?

기본적으로 PageNumber는 0부터 시작한다.

프론트엔드에서는 보통 1페이지부터 시작하는 것과 달리

백엔드에서는 페이징 처리 시, 페이지 넘버는 0페이지부터 시작한다는 뜻이다.

그렇다면 프론트엔드와 동일하게 페이지의 넘버를 1페이지부터 시작하게 하는 방법이 없을까?

지금부터 페이지를 1부터 시작하게 하는 방법으로 내가 아는 두 가지를 소개하려 한다.

1) Spring Boot 애플리케이션에서 Pageable 커스터마이징

페이지 번호를 0이 아닌 1부터 시작하도록 Pageable을 커스터마이징 할 수 있다.

PageableHandlerMethodArgumentResolverCustomizer는 Spring Boot에서 Pageable의 매개변수를 자동으로 매핑하는데 사용되는 인터페이스로, 이를 통해 페이지 요청의 기본 값을 설정하거나 페이지의 인덱스를 조정하는 등 다양한 커스터마이징 작업을 수행할 수 있다.

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
import org.springframework.context.annotation.Bean
import org.springframework.data.web.config.PageableHandlerMethodArgumentResolverCustomizer

@SpringBootApplication
class DevbabysApplication

fun main(args: Array<String>) {
	runApplication<DevbabysApplication>(*args)
}

// Pageable 커스터마이징
@Bean
fun customize(): PageableHandlerMethodArgumentResolverCustomizer {
	return PageableHandlerMethodArgumentResolverCustomizer { p ->
		p.setOneIndexedParameters(true) // 페이지 1부터 시작
		p.setMaxPageSize(20) // 페이지 크기를 20으로 설정
	}
}

setOneIndexedParameters(boolean oneIndexedParameters)
- 페이지 번호를 1부터 시작하도록 설정하는 속성
- 기본값은 false이며, 이는 페이지가 0부터 시작함을 의미한다.
setMaxPageSize(int maxPageSize)
- 기본 페이지 크기를 설정하는 속성
- 한 페이지에 표시할 항목의 수를 설정한다.

2) 서비스 로직에서 Pageable 페이지 조정

컨트롤러에서 받은 Pageable의 PageNumber를 서비스 로직에서 재조정한다.

프론트엔드에서 전달받은 1페이지는 백엔드에서는 0페이지를 의미한다.

때문에 1의 값을 받게 되면 0이 될 수 있도록 -1씩 재조정해주어야 한다.

Pageable 객체를 생성하기 위해 PageRequest.of 메서드를 사용한다.

val pageable: Pageable = PageRequest.of(page, size, sort);

아래는 프로젝트에서 사용된 Pageable의 페이지 수가 조정된 코드를 간소화한 코드이다.

1페이지부터 시작하도록하며, 페이지의 크기는 프론트엔드에서 원하는 수에 따라 조정 없이 불러올 수 있도록 하였다.

// RestController
@GetMapping("product/list")
fun listAllProduct(pageable: Pageable): ResponseEntity<Page<Product>> {
    val page = productService.getProductAllList(pageable)
    return ResponseEntity.ok(page)
}

// Service
fun getProductAllList(pageable: Pageable): Page<Product> {
    val customPage = PageRequest.of(pageable.pageNumber - 1, pageable.pageSize)
    val productList = productRepo.findAll(customPage)

    return productList
}

1페이지가 1부터 조회되는지 확인

1페이지를 조회했을 때, 2페이지가 아닌 1페이지의 값을 불러오도록 설정이 완료되었다.

아래의 API 응답 결과를 보면 데이터베이스의 첫 번째 값(productId=1)이 불러온 것을 확인할 수 있다.

Hugging Face - 인공지능 모델 로컬에 다운로드 받기

luvris2 — Mon, 17 Jun 2024 10:55:18 +0900

허깅 페이스에서 오픈 소스로 제공되는 모델들의 파일 다운로드 방법을 다룬다.

이 글은 파이썬을 이용하여 다운로드를 할 예정이므로 파이썬이 반드시 설치되어 있어야 한다.

huggingface_hub 라이브러리 설치

허깅 페이스에서의 공개된 리파지토리는 huggingface_hub 라이브러리를 통해 파일을 다운로드 받을 수 있다.

우선 huggingface_hub 라이브러리가 설치되어 있지 않다면 설치를 진행한다.

pip install huggingface_hub

허깅 페이스 모델 다운로드

모델을 다운로드하려면 hf_hub_download 혹은 snapshot_download 함수를 이용한다.

기본적으로는 함수에 repo_id와 repo_type을 인자로 넘겨주면 된다.

repo_type
- 매개변수를 생략하면 기본적으로 모델 리파지토리로 인식한다.
revision
- 파일 다운로드는 기본적으로 최신 버전의 파일을 다운로드한다.
- 만약 특정 버전의 파일을 다운로드 받으려면 revision 매개 변수를 이용하면 된다.
local_dir
- 특정 위치에 저장하고 싶을 때 사용한다.

아래는 함수별 샘플 구문이다. 참고하자.

hf_hub_download 구문

from huggingface_hub import hf_hub_download
hf_hub_download(repo_id="lysandre/arxiv-nlp", filename="config.json")

### 리파지토리의 타입이 다를 경우 ###
# 데이터세트의 경우
hf_hub_download(repo_id="google/fleurs", filename="fleurs.py", repo_type="dataset")

### 특정 버전에서 파일 다운로드를 할 경우 ###
# `v1.0` 태그에서 다운로드하기
hf_hub_download(repo_id="lysandre/arxiv-nlp", filename="config.json", revision="v1.0")
# `test-branch` 브랜치에서 다운로드하기
hf_hub_download(repo_id="lysandre/arxiv-nlp", filename="config.json", revision="test-branch")
# PR #3에서 다운로드하기
hf_hub_download(repo_id="lysandre/arxiv-nlp", filename="config.json", revision="refs/pr/3")
# 특정 커밋 해시에서 다운로드하기
hf_hub_download(repo_id="lysandre/arxiv-nlp", filename="config.json", revision="877b84a8f93f2d619faa2a6e514a32beef88ab0a")

snapshot_download 구문

from huggingface_hub import snapshot_download
snapshot_download(repo_id="lysandre/arxiv-nlp")

### 리파지토리의 타입이 다를 경우 ###
# 데이터세트의 경우
snapshot_download(repo_id="google/fleurs", repo_type="dataset")

### 특정 버전의 리파지토리를 다운로드 할 경우 ###
from huggingface_hub import snapshot_download
snapshot_download(repo_id="lysandre/arxiv-nlp", revision="refs/pr/1")

사용 예시 - MMLU 데이터셋 다운로드 받아보기

사용 예시로 mmlu 데이터셋을 특정 위치에 다운로드 받아보자.

mmlu는 인공지능 언어 모델의 기능을 평가하기 위한 방법 중 하나이다.

from huggingface_hub import snapshot_download
snapshot_download(repo_id="lighteval/mmlu", repo_type="dataset", local_dir="C:\\dataset\\")

MMLU 데이터셋 다운로드 예시 화면

다운로드 받은 데이터셋을 로컬 경로에서 확인한 예시 화면

MySQL - 외래 키 제약 조건으로 업데이트가 되지 않는 행 강제 업데이트 하기 (외래 키 제약 조건 비활성화)

luvris2 — Fri, 14 Jun 2024 15:03:47 +0900

개요

A테이블의 id컬럼을 참조하는 B테이블이 있다.

여기서 A테이블의 id컬럼 값을 변경하려고 할 때,

데이터 일관성을 유지해야하기 때문에 참조 무결성의 제약 조건으로 업데이트를 할 수 없다.

하지만 가끔 잘못 넣은 값을 다른 값으로 업데이트해주어야 할 때가 있는데,

FK 때문에 참조 관계로 엮여있어서 계속 오류가 발생하여 값을 업데이트하지 못한다.

발생되는 오류는 다음과 같다.

Error Code: 1451.
Cannot delete or update a parent row:
	a foreign key constraint fails
    (`database`.`FK table`, CONSTRAINT `FK Name` FOREIGN KEY (`id`)
    REFERENCES `table` (`id`))

ON UPDATE CASCADE를 사용하는 방법이 있지만...

테이블을 변경했다가 다시 되돌리는 건 사실 너무 귀찮고,

일회성으로 잠깐 빠르게 수정하고 싶다.

외래 키 제약 조건 활성화 / 비활성화 하기

특정 컬럼의 값이 외래 키 제약 조건에 걸려 값을 업데이트하지 못할 때

외래 키 제약 조건을 잠깐 비활성화 했다가 값을 업데이트 후,

다시 외래 키 제약 조건을 활성화 하면 된다.

외래 키 제약 조건 비활성화 쿼리

SET FOREIGN_KEY_CHECKS = 0;

외래 키 제약 조건 활성화 쿼리

SET FOREIGN_KEY_CHECKS = 1;

이 기능의 장점으로는 필요한 작업을 신속하게 수행할 수 있다는 것인데,

외래 키 제약 조건을 비활성화하면 데이터 무결성이 손상될 수 있으므로

상황에 따라 반드시 필요한 경우에만 비활성화하고 작업이 완료되면 즉시 다시 활성화하는 것이 좋다.

또한, 다중 사용자 환경에서 이 설정을 변경하면 다른 사용자가 수행하는 작업에도 영향을 미칠 수 있으므로 주의하여야 한다.

외래 키 제약 조건이 걸린 행 업데이트 예시

예시를 위한 샘플 테이블

설명을 위해 간소화 하였다.

product 테이블

product_id, int, PK
name, varchar(255)

product_image 테이블

image_id, int, PK
url, varchar(255)
product_id, int, FK ( product(product_id) )

예시를 위한 샘플 데이터

product 테이블

	product_id	name
1행	999	아이템1

product_image 테이블

	image_id	url	product_id
1행	123	https:~~	999

시나리오

외래 키로 참조하는 product_id의 값이 999이지만, 1로 변경하고 싶다.

하지만 외래 키 제약 조건으로 인해서 업데이트가 불가능한 상황이다.

작성 쿼리

-- 외래 키 제약 조건 비활성화
SET FOREIGN_KEY_CHECKS = 0;

-- product 테이블 강제 업데이트
update product
set product_id = 1;

-- product_image 테이블 강제 업데이트
update product_image
set product_id = 1;

-- 외래 키 제약 조건 활성화
SET FOREIGN_KEY_CHECKS = 1;

변경 전 / 후 값 비교

변경 전: product_id 999

외래 키 걸려 있는 행을 강제 업데이트 하기 전의 예시 이미지

변경 후: product_id 1

외래 키 걸려 있는 행을 강제 업데이트 한 후의 예시 이미지

Git - 저장소에 이미 Commit/Push 된 이전 커밋 버전 삭제하기 (커밋 히스토리 제거하기)

luvris2 — Wed, 12 Jun 2024 15:28:17 +0900

개요

실수로 서버 정보가 담긴 설정 파일을 푸시해버렸다.

급히 설정 파일의 정보를 비우고 새롭게 푸시하였으나,

문제는 이전 커밋에는 이미 서버의 정보가 담겨있는 설정 파일이 존재한다는 것이다.

비공개 리파지토리면 상관이 없으나 이는 공개 리파지토리로 작업을 진행하기로 한 토이 프로젝트였다.

이렇게 잘못 푸시된 민감 정보가 담겨있는 이전 버전은 어떻게 없애야 할까?

커밋 이전 버전 확인하기

커밋 버전 확인은 크게 두 가지가 있는 것 같다.

첫 번째는 명령어를 통한 로그 확인과

두 번째는 깃허브 리자피토리에서 직접 커밋을 확인하는 방법이 있다.

명령어는 git log를 통해서 확인할 수 있다.

git log

리파지토리에서 확인하는 방법은

해당 리파지토리 페이지로 이동 후, 파일 목록 중 오른쪽 상단의 커밋 수를 누르면 된다.

커밋 이전 버전을 확인하기 위한 경로 표시 이미지

그럼 다음 이미지와 같이 커밋한 이전 버전들의 목록이 뜬다.

깃허브에 이전 버전을 확인하는 목록 예시

특정 커밋 시점으로 되돌리기

특정 커밋 버전으로 되돌리려면 git reset이라는 명령어를 이용하면 된다.

# option #
# --soft
# --mixed
# --hard
git reset --soft #commit hash

명령어를 통해 특정 커밋 버전의 해시 코드를 입력하면,

입력한 커밋 버전으로 상태가 되돌아간다.

깃허브 사이트에서 버전을 확인하는 목록에서 우측을 보면 쉽게 확인 및 복사할 수 있다.

커밋 버전 복사 경로 예시 이미지

여기서 리셋 옵션에 따라 디렉토리의 파일이 변경될 수 있는데 주의하여야 한다.

나는 작업한 내용은 그대로 유지하고 커밋만 삭제할 예정이기 때문에 --soft 옵션을 사용하여 진행하겠다.

소프트 옵션은 파일까지 되돌아가는게 아니고 커밋 시점만 이전으로 돌아간다.

만약 특정 커밋 시점의 파일 상태까지 모두 되돌려야 한다면 --hard 옵션을 사용하자.

단, 현재 작업 중인 내용은 사라질 수 있다.

# 예시
git reset --soft e0d9adff8932b05bf864d~

예시 이미지에서 커밋 목록 중 'add index page'의 상태로 커밋을 되돌렸다.

이제 커밋 없이 강제로 푸시를 진행해준다.

git push -f

커밋 한 내용이 없기 때문에 커밋은 현재 작업 디렉토리의 파일이 반영되지 않고

당시 커밋을 했을 내용으로 되돌아가게 된다.

특정 커밋 상태로 되돌아 간 후, 이후의 커밋은 삭제된 예시 화면

깃허브는 협업과 버전을 관리하기 위한 도구이기 때문에

커밋을 되돌릴 때는 협업하는 팀원과 충분한 대화를 한 후 진행하는 것이 바람직하다.

reset 옵션 설명

--soft

작업 디렉토리와 스테이징 영역이 유지된 채 커밋만 되돌아간다.

커밋을 잘못했지만, 변경된 파일들은 그대로 두고 싶을 때 사용한다.

예시)

A 커밋 -> B 커밋이 있는데, B 커밋을 취소하고 싶을 때 사용
B 커밋의 내용은 그대로 스테이징 영역에 남아 있어서 다시 커밋하거나 수정할 수 있다.

--mixed

작업 디렉토리는 유지된 채 스테이징 영역과 커밋이 되돌아간다.

커밋을 잘못했고, 다시 스테이징해서 커밋하고 싶을 때 사용한다.

예시)

A 커밋 -> B 커밋이 있는데, B 커밋을 취소하고 싶을 때 사용
B 커밋의 내용은 스테이징 영역에서 사라지고, 작업 디렉토리에 그대로 남아 있어서 다시 스테이징해서 커밋할 수 있다.

--hard

작업 디렉토리, 스테이징 영역, 커밋 모두 되돌아간다.

커밋을 잘못했고, 변경된 파일들도 모두 초기 상태로 되돌리고 싶을 때 사용한다.

해당 옵션은 되돌릴 수 없는 변경을 초래할 수 있으므로 신중하게 사용해야 한다.

예시)

A 커밋 -> B 커밋이 있는데, B 커밋을 취소하고 싶을 때 사용
B 커밋의 내용은 스테이징과 작업 디렉토리에서 모두 사라져서 다시 커밋할 수 없고, 변경 사항 모두 사라진다.

Spring Boot - application.properties의 민감 정보 분리하기

luvris2 — Tue, 11 Jun 2024 17:39:38 +0900

개요

보통 application.properties에 환경 설정 기재하여 개발을 진행하고는 하는데,

문제는 깃허브 같은 공개된 리파지토리에 프로젝트 파일을 올릴 때 문제가 발생한다.

만약, 서버 정보나 데이터베이스 접속 정보가 포함될 경우에는 매우 위험하기 때문이다.

기본 설정 파일의 민감 정보 분리하기

추가 설정 파일 만들기

기본 설정 파일인 application.properties가 존재하는 같은 경로에

민감 정보를 따로 저장할 설정 파일(*.properties)을 하나 새로 추가한다.

필자는 데이터베이스의 접속 정보를 분리할 예정이기에 데이터베이스의 접속 정보를 분리하려 한다.

파일명의 주어진 작명 형식은 따로 없다.

포스팅에서는 application-database.properties라고 하겠다.

프로젝트 내 속성 파일을 추가한 예시 화면

추가 설정 파일 내용 입력하기

새로 만든 설정 파일(application-database.properties)에 데이터베이스 접속 정보를 입력한다.

# application-database.properties #
spring.datasource.url = jdbc:mysql://~
spring.datasource.driverClassName = com.mysql.cj.jdbc.Driver
spring.jpa.database-platform=org.hibernate.dialect.MySQLDialect
spring.datasource.username = ~
spring.datasource.password = ~

데이터베이스 접속 설정 예시 화면

기본 설정 파일에서 다른 설정 파일 가져오기

이제 기본 설정 파일(application.properties)에 추가 설정 파일(application-database.properties)을 포함시켜 보자.

추가 설정 파일을 가져오는 구문은 아래와 같다.

spring.config.import = 추가 설정 파일명 입력

예시

# application.properties #

# 기본 설정
server.port=8080
logging.level.root=DEBUG

# 데이터베이스 설정
spring.config.import=application-database.properties

Kotlin - Data Class에 대해 (Class와의 차이점, 샘플 코드, 생성 메서드 직접 구현해보기)

luvris2 — Mon, 10 Jun 2024 17:38:48 +0900

간단히 알아보는 Data Class란?

데이터 클래스는 코틀린 언어에서 제공하는 클래스 유형으로,

주로 데이터를 보유하고 전달하는 것을 목적으로 만들어진 클래스이다.

전반적으로 데이터 클래스는 데이터 모델 및 DTO를 만들고 관리하기 위해 사용된다.

코틀린에서 data class를 선언하여 기본 생성자를 초기화 할 때,

기본 생성자 매개변수를 기반으로 하는 여러 유용한 메서드들을 컴파일러가 자동으로 생성한다.

자동으로 생성되는 메서드를 이용하여 프로그래머는 보다 편하고 쉽게 코드를 구성할 수 있도록 도와준다.

자동으로 생성되는 메서드는 다음과 같다.

equals() : 객체의 내용 비교
hashCode() : 해시 기반 자료구조에서 사용
toString() : 객체를 문자열로 표현
copy() : 객체의 일부 속성만 변경한 새 객체 생성
componentN() : 구조 분해 할당

Q. 일반 Class와의 차이는?

일반 class는 data class와 달리 위의 기능들이 자동으로 생성되지 않기 때문에 직접 구현해야 한다.

Data Class는 왜 쓰는걸까?

코드의 간결성 제공 및 반복적인 코드 감소

데이터 객체를 정의하고 조작해야 하는 상황에서

데이터가 정확하게 일치하는지 등의 확인 작업을 하다보면 코드가 다소 복잡해질 수 있다.

이럴 때, 데이터 클래스의 생성된 메서드들을 이용하면

명시적으로 작성할 필요 없이 데이터 모델을 간결하게 정의하는 방법을 제공한다.

이는 코드를 더 읽기 쉽고 이해하기 쉽게 코드를 만들어주기 때문에 유지보수성에서도 매우 유용하다.

안정적인 데이터 제공

모든 기본 생성자 매개 변수는 val 또는 var로 선언된다.

데이터 클래스는 불변성(Immutability)을 제공하도록 설계되었다.

그래서 기본적으로 data class의 속성은 val(읽기 전용)으로 선언된다.

불변성을 장려하는 클래스는 더 예측 가능하고 안정적인 코드를 만들어 오류 발생률을 줄일 수 있다.

Q. var로 선언하면 불변성이 제공되는 것이 아니지 않을까?

물론 명시적으로 속성을 var로 선언할 수는 있으나,

데이터 클래스에서 생성된 매서드가 생성자 매개변수의 초기 값을 기반으로 하기 때문에

가변성을 허용하게 되며 이는 곧 다른 인스턴스에 영향을 미칠 수 있으며

데이터 클래스를 기반으로 하는 해시 테이블, 데이터 구조에서 오류를 초래할 수 있다.

이는 곧 데이터 무결성 문제로 이어질 수가 있어서 유의해야 한다.

예시로 알아보는 데이터 클래스 사용법

데이터 클래스 선언

클래스 앞에 data 키워드를 선언한다.

기본 생성자로 생성될 매개 변수를 정의한다.

data class User (
	val name: String,
    val age: Int
)

데이터 추가

생성자에 값을 넣어준다.

다른 프로그래밍 언어의 생성자 생성 방식과 동일하다.

fun main() {
	// User 데이터 클래스에 값 추가
    val user1 = User("Eunbyeol", 35)
    val user2 = User("tester", 1)
}

위와 같이 코드를 작성하게 되면 각각 user1, user2에 대한 유용한 메서드가 자동으로 생성된다.

자동 생성 메서드 활용

주석을 보고 어떻게 작동하는지 이해해보자.

fun main() {
	// User 데이터 클래스에 값 추가
    val user1 = User("Eunbyeol", 35)
    val user2 = User("Eunbyeol", 35)
    
    // equals() 메서드 자동 생성
    println(user1 == user2) // true

    // hashCode() 메서드 자동 생성
    println(user1.hashCode() == user2.hashCode()) // true

    // toString() 메서드 자동 생성
    println(user1) // User(name=Eunbyeol, age=35)

    // copy() 메서드 자동 생성
    val user3 = user1.copy(age = 999)
    println(user3) // User(name=Eunbyeol, age=999)

    // componentN() 메서드 자동 생성
    val (name, age) = user1
    println("Name: $name, Age: $age") // Name: Eunbyeol, Age: 35
}

일반 클래스로 위와 같은 메서드를 사용하면 어떤 결과가 나올까?

데이터 클래스는 기본 생성자의 매개 변수를 이용하여 자동으로 유용한 메서드를 제공한다고 하였다.

그렇다면 일반 클래스는 어떻길래 데이터 클래스를 사용하는게 편하다고 하는 것일까?

직접 결과를 확인해보자.

일반 클래스 선언

class RegularUser(
	val name: String,
    val age: Int
) { }

메서드 작동 확인

데이터 클래스에서 확인했던 메서드의 결과값과 전혀 다른 값이 출력되는 것을 확인할 수 있다.

fun main() {
    // User 일반 클래스에 값 추가
    val user4 = RegularUser("Eunbyeol", 35)
    val user5 = RegularUser("Eunbyeol", 35)

    // equals() 메서드
    println(user4 == user5) // false

    // hashCode() 메서드
    println(user4.hashCode() == user5.hashCode()) // false

    // toString() 메서드
    println(user4) // org.example.RegularUser@79fc0f2f
}

자동 생성 메서드를 직접 구현을 해야 한다면?

일반 클래스 equals(), hashCode(), toString() 메서드 직접 구현 코드

생성자의 매개변수를 확인하여 오버라이딩한다.

class RegularUser(val name: String, val age: Int) {

    // equals() 메서드 직접 구현
    override fun equals(other: Any?): Boolean {
        if (this === other) return true
        if (other !is RegularUser) return false
        return name == other.name && age == other.age
    }

    // hashCode() 메서드 직접 구현
    override fun hashCode(): Int {
        return name.hashCode() * 31 + age
    }

    // toString() 메서드 직접 구현
    override fun toString(): String {
        return "RegularUser(name=$name, age=$age)"
    }
}

구현 확인

데이터 클래스에서 확인했던 값과 동일한 것을 확인할 수 있다.

fun main() {
    // User 일반 클래스에 값 추가
    val user4 = RegularUser("Eunbyeol", 35)
    val user5 = RegularUser("Eunbyeol", 35)

    // equals() 메서드
    println(user4 == user5) // true

    // hashCode() 메서드
    println(user4.hashCode() == user5.hashCode()) // true

    // toString() 메서드
    println(user4) // RegularUser(name=Eunbyeol, age=35)
}

추가 정보. 해시 코드를 구할 때 31을 사용하는 이유는?

간단히 요약하면 31이라는 숫자는 소수(Prime Number)로,

해시 충돌(다른 객체가 같은 해시 값을 가지는 현상)의 가능성을 줄이고

컴파일러가 최적화를 수행할 때 곱셈 연산으로 최적화 될 수 있다.

(비트 시프트와 뺄셈으로 변환할 수 있어 성능 이점이 있다.)

문자열과 같은 일반적인 데이터에 대해 좋은 분포를 제공한다.

실제 Java의 String. Integer 등 많은 핵심 클래스들도 31이라는 숫자를 사용한다.

MySQL Workbench - ERD 추출하여 그리기, 추출된 ERD를 이미지로 저장하기

luvris2 — Wed, 5 Jun 2024 17:07:34 +0900

개요

데이터베이스의 데이터 모델링 설계 시,

설계된 데이터 테이블의 설계도를 시각화해야할 때가 있다.

ERD(Entity Relationship Diagram)은

데이터베이스에서 모델링된 요소들의 관계를 시각적으로 보여주는 엔터티 관계 다이어그램인데,

주로 데이터베이스의 설계된 모델을 시각적으로 표현하고 관계를 설명할 때 사용된다.

이번 포스팅에서는 ERD를 직접 그리는 방법보다는

실제로 MySQL 데이터베이스 내에 설계되어 있는 데이터 테이블을 추출하여

ERD로 자동으로 그려주는 방법에 대해 설명하고자 한다.

이 글은 MySQL Workbench의 기능을 이용하여 ERD를 그리는 것을 목적으로 한다.

실제 데이터베이스의 테이블을 ERD로 그리기

우선, MySQL Workbench를 실행한다.

워크벤치 상단 메뉴에서

Database - Reverse Engineer 선택

워크벤치 메인 화면에 MySQL Connections에

이미 접속할 데이터베이스의 프로필이 저장되어 있다면

아래와 같이 저장된 정보가 미리 입력되어 나올 것이다.

접속할 Hostname, Port, Username, Password를 확인하고 Next 버튼을 누른다.

만약 접속할 프로필이 없다면,

Stored Connection을 눌러 Manage Stored Connections을 통해 프로필을 새로 지정하거나

아니면 그냥 호스트 정보를 직접 기입한다.

프로필을 새로 지정하기 위한 예시 화면

데이터베이스에 접속이 되었다는 문구가 출력된다. Next를 눌러 다음 단계로 진입해준다.

데이터베이스 접속 확인 예시 화면

ERD를 추출할 데이터베이스를 선택 한 후, Next를 눌러 다음 단계로 진입한다.

포스팅에서는 토이 프로젝트를 위해 간이 설계된 "devbabys_shoppingmall"라는 이름의 데이터베이스를 선택하였다.

ERD를 추출할 데이터베이스 선택 예시 화면

ERD를 그릴 스키마를 찾았다는 문구가 출력된다. Next를 눌러 다음 단계로 진입하자.

ERD를 만들 스키마를 찾았다는 내용의 예시 화면

ERD를 구성할 테이블 목록을 확인한다.

Show Filter 버튼을 누르면 테이블의 목록이 출력된다.

여기서 내가 ERD로 그릴 테이블만 선택할 수 있다.

포스팅에서는 모든 테이블의 ERD를 그릴 예정이므로 따로 제외하지 않고 진행하겠다.

실제 ERD를 구성할 때에는 각 주제의 성격에 맞는 테이블들로 구성하여 문서화하는 것이 좋다.

구성할 테이블 목록을 선택하였으면 하단의 Execute 버튼을 누른다.

ERD를 구성할 테이블 선택 예시 화면

Reverse Engineer Database 팝업은 ERD가 생성되었다는 문구들로 구성되어있기 때문에

따로 설정할 필요 없이 Next - Finish를 눌러 팝업을 닫는다.

MySQL Workbench에서는 ERD 다이어그램이 그려진 것을 확인할 수 있다.

MySQL 워크벤치를 통해 ERD 다이어그램을 자동 생성한 예시 화면

ERD 이미지로 저장하기

생성된 ERD 다이어그램을 다른 사람들에게도 보여줄 수 있도록 이미지 파일로 저장해보자.

MySQL 워크벤치 상단 메뉴에서 File - Export를 선택하고, 생성할 파일의 종류를 선택한다.

포스팅에서는 이미지 파일로 만드는 것이 목적이기 때문에 Export as PNG를 선택하였다.

생성된 ERD 다이어그램을 이미지로 변환화는 과정

"test erd.png"란 이름으로 내 컴퓨터에 저장하였다.

저장된 ERD 이미지는 이상 없이 깔끔하게 잘 저장되었다.

추출된 ERD 이미지 파일을 불러온 예시 화면

MSSQL - 스케줄러 사용법 (스케줄 생성, 작업 일정 설정, 스케줄러 실행)

luvris2 — Thu, 30 May 2024 13:13:59 +0900

개요

주기적으로 혹은 어쩌다가 한번씩 대량의 데이터를 입력하거나 수정해야 할 때가 있다.

하지만 실제로 서비스 중인 데이터베이스 서버에 대량의 값을 넣으려면

다량의 I/O 작업으로 인해 과부하가 발생되어 데이터베이스의 성능이 저하되므로 함부로 작업을 수행하기는 어렵다.

이럴 때, 가능한한 서비스 사용자의 이용이 적은 시간대에 스케줄러를 이용하여

대량의 데이터를 삽입하는 작업을 하면 서비스의 품질 불량을 최소화할 수 있다.

오늘은 스케줄러를 이용하여 일정을 정하고,

정해진 일정에 입력된 작업을 데이터베이스에 수행되도록 하는 방법에 대해 알아본다.

참고 글

스케줄러 생성에 관련하여 참고될만한 글 목록이다.

자신의 상황과 같은 현상이 일어난다면 확인해보자.

SQL Server Agent 가 없거나 중지 상태 일 경우 해결 방법

MSSQL - SQL Server Agent 활성화하기 (SQL Server 에이전트 설치)

SQL Server Agent을 설정하려고 하는데 SQL Server 구성 관리자가 없을 경우 해결 방법

MSSQL - SQL Server 구성 관리자 없음, 설치, 다운로드, SQL Server Configuration Manager 위치

스케줄러 생성하기

스케줄러 생성 예시 화면

스케줄러 설정하기 - 기본 설정

New Job - General (새 작업 - 일반)

Name(이름) : test
Category(범주) : 테스트이므로 따로 지정하지 않음

스케줄러 일반 설정 예시 화면

스케줄러 설정하기 - 수행할 작업 설정

New Job - Steps (새 작업 - 단계)

New(새로 만들기)

스케줄러 단계 설정 예시 화면

New Job - Steps - New Job Step (새 작업 - 단계 - 새 작업 단계)

Step name(단계 이름) : 사용자가 식별이 가능한 이름 정의
Database(데이터베이스) : 사용할 데이터베이스
Command(명령) : 데이터베이스 내에서 실행할 쿼리 내용
포스팅에서는 테스트 테이블에 값 하나를 추가하는 내용의 스케줄러를 작성하였음.

-- 예시 작성 쿼리
insert into t1 (col1, col2)
	values (val1, val2)

스케줄러 수행할 작업 정의 예시 화면

스케줄러 설정하기 - 작업을 수행할 시간 및 빈도 설정

New Job - Schedules (새 작업 - 일정)

New(새로 만들기)

스케줄러 일정 설정 예시 화면

New Job - Schedules - New Job Schedule (새 작업 - 일정 - 새 작업 일정)

Name(이름) : 사용자가 식별 가능한 작업 일정 이름 정의
Schedule type(일정 유형)
- Start automatically when SQL Server Agent starts (SQL Server 에이전트가 시작될 때 자동으로 시작)
  - 서버 재부팅 후 초기화 작업을 수행할 때 사용 (예: 로그 파일 초기화)
  - 서버 중단 및 재개를 할 때 필요한 작업을 자동으로 실행하도록 할 때 사용 (예: 시스템 상태 점검)
- Start whenever the CPUs become idle (CPU가 유휴 상태로 될 때마다 시작)
  - 서버의 CPU 사용률이 낮아져 유휴 상태가 될 때 작업 실행
  - 유휴 상태를 감지하여 시스템 성능에 미치는 영향을 최소화하기 위해 리소스 집약적인 작업을 수행할 때 사용 (예: 인덱스 재구성)
  - 정기적인 유지보수 작업이나 백업 작업을 CPU가 유휴 상태일 때 실행하여 사용자가 활동 중인 시간대에도 영향을 주지 않도록 하기 위해 사용 (예: 데이터 백업)
- Recuring (되풀이)
  - 해당 옵션 선택 시 Frequency(빈도)에서 일정을 시작할 날짜를 지정해야 함
- One time(한 번)
  - 해당 옵션 선택 시 One-time occurrence(한 번 발생)에서 일정을 시작할 날짜를 지정해야 함
- 포스팅에서는 한 번 실행으로 설정하고, 1분 뒤에 값이 추가되도록 설정하였음.

스케줄러 일정 세부 설정 예시 화면

OK 버튼을 눌러 스케줄러를 생성해 보자.

스케줄러 확인하기

아래의 경로에서 생성한 스케줄러를 확인해 볼 수 있다.

Object Exploer (개체 탐색기)
- SQL Server Agent (SQL Server 에이전트)
  - Jobs (일정)
    - 생성한 스케줄러 확인

개체 탐색기에서 생성한 스케줄러 확인 예시 화면

스케줄러 일정 작동 확인 테스트

테스트용 테이블에 '고은별', '인천'이라는 값을 추가되었는지 확인해 보자.

스케줄러 설정 시 일정에서 1분 뒤에 추가되도록 하였으니,

1분 뒤에는 값이 추가되어야 한다.

초기 테스트 테이블의 값

테스트 테이블의 초기 값

1분 뒤 스케줄러가 실행되어 작업을 수행한 테스트 테이블의 값
- 스케줄러의 일정에 맞게 설정한 작업이 정상적으로 실행되어 값이 추가됨을 확인할 수 있다.

스케줄러가 작업을 수행하여 값이 추가된 테이블 조회 화면

MSSQL - SQL Server Agent 활성화하기 (SQL Server 에이전트 설치)

luvris2 — Thu, 30 May 2024 00:30:38 +0900

개요

MSSQL에서 스케줄러 사용을 위해 SQL Server Agent를 확인해보았더니 비활성화가 되어있다.

MSSQL에서 SQL Server 에이전트가 비활성화된 예시 화면

아마 이 글을 보는 분들도 비활성화가 되어 있거나 설치를 하기 위해 이 글을 읽고 있으리라 생각된다.

SQL Server 에이전트가 비활성화(중지)가 되어 있다면,

MSSQL의 개체 탐색기에서 SQL Server Agent가 다음 이미지와 같은 빨간색을 하고 있거나 아예 없을 것이다.

중지 예시 이미지

SQL Server 에이전트 활성화하기

SQL Server 구성 관리자 도구를 실행한다.

만약 SQL Server 구성 관리자 도구를 찾지 못하겠다면 아래의 링크를 확인해보자.

MSSQL - SQL Server 구성 관리자 없음, 설치, 다운로드, SQL Server Configuration Manager 위치

MSSQL - SQL Server 구성 관리자 없음, 설치, 다운로드, SQL Server Configuration Manager 위치

이 글은 윈도우 운영체제를 기반으로 설명이 작성되었습니다.경로 확인은 윈도우의 경로를 기준으로 합니다. SQL Server 구성 관리자란?연결된 서비스를 관리하고, 네트워크 프로토콜을 구성하며

luvris2.tistory.com

SQL Server 구성 관리자 실행 화면 예시

좌측의 목록에서 SQL Server 서비스를 선택
이름이 SQL Server 에이전트 (MSSQLSERVER)인 항목 마우스 우클릭 - 시작

SQL Server 에이전트 시작 예시 화면

시작이 된 후, MSSQL 개체 탐색기를 확인해보면 SQL Server Agent가 정상적으로 시작되어 활성화됨을 확인할 수 있다.

SQL Server 에이전트에서 빨간색이 아닌 초록색을 띄면 정상적으로 시작되고 있다는 의미이다.

SQL Server에서 SQL Server 에이전트가 정상적으로 실행되고 있음을 확인하는 예시 이미지

SQL Server 에어전트 자동 활성화 하기

이번엔 수동이 아닌 다음번부터는 자동으로 SQL Server Agent가 시작되도록 설정해보자.

마찬가지로 이 것도 SQL Server 구성 관리자(SQL Server Configuration Manager)에서 할 수 있다.

좌측의 목록에서 SQL Server 서비스를 선택
이름이 SQL Server 에이전트 (MSSQLSERVER)인 항목 마우스 우클릭 - 속성

SQL Server 에이전트 자동 시작 설정 예시 화면

서비스 탭으로 이동
시작 모드 : 자동으로 변경

SQL Server 에이전트 자동 시작 속성 설정 예시 화면

MSSQL - SQL Server 구성 관리자 없음, 설치, 다운로드, SQL Server Configuration Manager 위치

luvris2 — Wed, 29 May 2024 13:31:09 +0900

이 글은 윈도우 운영체제를 기반으로 설명이 작성되었습니다.

경로 확인은 윈도우의 경로를 기준으로 합니다.

SQL Server 구성 관리자란?

연결된 서비스를 관리하고, 네트워크 프로토콜을 구성하며,

클라이언트 컴퓨터에서 네트워크 연결 구성을 관리하는 도구이다.

SQL Server 구성 관리자가 없을 경우

윈도우 키를 눌러 SQL Server 구성 관리자 도구를 찾아보았지만 검색되지 않는다.

sql server 구성 관리자 도구를 찾는 예시 이미지

SQL Server(MS-SQL) 설치 시 기본적으로 함께 제공되는 도구이다.

때문에 따로 SQL Server 구성 관리자 도구를 다운로드 받거나 설치할 필요가 없다.

SQL Server 구성 관리자 도구 실행하기

아래의 표는 버전에 따른 SQL Server 구성 관리자 도구의 설치 경로이다.

버전	Path
SQL Server 2022	C:\Windows\SysWOW64\SQLServerManager16.msc
SQL Server 2019	C:\Windows\SysWOW64\SQLServerManager15.msc
SQL Server 2017	C:\Windows\SysWOW64\SQLServerManager14.msc
SQL Server 2016	C:\Windows\SysWOW64\SQLServerManager13.msc
SQL Server 2014(12.x)	C:\Windows\SysWOW64\SQLServerManager12.msc
SQL Server 2012(11.x)	C:\Windows\SysWOW64\SQLServerManager11.msc

내가 사용하는 SQL Server 의 버전을 잘 모른다면 CMD(명령 프롬프트)에서 아래의 명령어를 쳐보자.

자신 컴퓨터에 설치되어 있는 SQL Server 구성 관리자 도구를 확인할 수 있다.

dir C:\Windows\SysWOW64\SQLServerManager*.msc /S /B

나의 경우를 예로 들자면,

SQL Server 2019가 설치되어 있어서 구성관리자의 파일명은 SQLServerManager15.msc로 검색되었다.

SQLServerManager, SQL Server 구성 관리자 도구의 파일 경로를 찾는 예시 이미지

확인된 경로에서 직접 구성 관리자를 실행하거나

혹은 CMD로 경로를 확인한 후, 아래의 명령어를 통해 실행하면 된다.

참고 : mmc 명령어는 윈도우 운영체제에서 다양한 시스템 관리 도구들을 하나의 통합된 인터페이스에서 관리할 수 있게 해주는 콘솔 애플리케이션을 뜻한다.

mmc 구성 관리자 경로

# 예시
# mmc C:\Windows\SysWOW64\SQLServerManager15.msc

SQL Server Configuration Manager가 정상적으로 잘 실행됨을 확인할 수 있다.

SQL Server 구성 관리자 실행 화면 예시 이미지

MSSQL Error) ntext 데이터 형식은 비교할 수 없으므로 DISTINCT로 선택할 수 없습니다.

luvris2 — Tue, 28 May 2024 09:48:25 +0900

개요

컬럼의 중복된 값을 조회하지 않기 위해 SELECT 구문에 DISTINCT 키워드를 추가하였다.

그런데 다음과 같은 오류가 출력되었다.

Msg 421, Level 16, State 1, Line 76
ntext 데이터 형식은 비교할 수 없으므로 DISTINCT로 선택할 수 없습니다.

확인해보니 컬럼의 데이터타입이 ntext로 되어있다.

이 오류가 왜 발생했고, 어떻게 해결하는지 알아보자.

발생 원인

ntext 데이터타입은 SQL Server에서 직접적으로 비교하는 DISTINCT, GROUP BY와 같은 비교 연산자와

UNION, EXCEPT 같은 집합 연산과 COUNT, SUM과 같은 집계 함수(집계 연산)을 수행할 수 없다.

집합 연산을 수행할 경우에는 다음과 같은 오류 메시지가 출력된다.

Msg 5335, Level 16, State 1, Line 97
데이터 형식 ntext은(는) 비교할 수 없으므로 UNION, INTERSECT 또는 EXCEPT 연산자의 피연산자로 사용할 수 없습니다.

집계 연산을 수행할 경우에는 다음과 같은 오류 메시지가 출력된다.

Msg 8117, Level 16, State 1, Line 86
max 연산자에 대한 피연산자 데이터 형식 ntext이(가) 잘못되었습니다.

해결 방법

CAST 또는 CONVERT를 사용하여 데이터 타입을 비교할 수 있도록 nvarchar 타입으로 변환하면 된다.

/* TABLE NAME 	: t1
    COLUMNS     : col1 (ntext)
*/
SELECT DISTINCT
	CONVERT(NVARCHAR(MAX), col1)
FROM
	t1

혹시라도 데이터 타입을 변환하였을 때 데이터의 손실(문자 타입 변경으로 인한)이 우려된다면 걱정하지 않아도 된다.

ntext, nvarchar 모두 유니코드를 지원하므로 문자 집합의 차이로 인한 데이터 손실은 없다.

윈도우 명령 프롬프트(CMD) - 파일 복사 명령어, copy/xcopy 차이점과 관련 옵션

luvris2 — Mon, 27 May 2024 10:07:22 +0900

이번 포스팅은 윈도우 운영체제에서 터미널(명령 프롬프트)로 파일을 복사하는 방법을 다루겠다.

개인적으로 생각보다 많이 사용하고 있는데 xcopy 옵션이 자주 헷갈려서 찾아보는 김에 정리 해보았다.

copy 사용법

구문

다른 한 위치에서 하나 이상의 파일을 복사하는 데 사용된다.

copy 원본파일 대상파일

예시

예를 들어 다음과 같은 디렉토리를 가정할 경우,

test 폴더 하위에 있는 test.txt 텍스트 파일을 다른 'a' 폴더에 복사하는 방법을 예시로 들어보자

# 예시 디렉토리
c:\	- test	- test.txt
	ㄴa

copy c:\test\test.txt c:\a\test.txt

xcopy 사용법

구문

하위 디렉터리를 포함하여 파일 및 디렉터리를 복사하는 데 사용된다.

추가적으로 지정하는 옵션에 따라 복사를 제어할 수 있다.

xcopy 원본경로 대상경로 [/옵션지정]

옵션

옵션은 주관적으로 자주 쓰는 옵션에 대해서만 설명하겠다.

/e : 하위 디렉토리 구조를 포함하여 모든 파일과 디렉토리를 복사한다.
/i : 대상 폴더가 없으면 새로 만든다.
- 대상이 디렉토리일 경우를 가정한다. 이 옵션이 없으면 대상이 파일인지 디렉토리인지 묻는 메시지가 나타난다.
/y : 기존 파일을 덮어쓸지 묻는 메시지를 표시하지 않고 자동으로 덮어쓰기를 한다.

예시

예를 들어 다음과 같은 디렉토리를 가정할 경우,

test 폴더 하위에 있는 test.txt 텍스트 파일과 'a' 폴더를 'xcopy' 폴더로 복사하는 방법을 예시로 들어보자

# 예시 디렉토리
c:\	- test	- test.txt
		ㄴa
    ㄴxcopy

xcopy c:\test c:\xcopy /e

/e 옵션은 모든 하위 디렉토리가 비어있더라도 복사하는 기능을 한다.

copy VS xcopy

주요 차이점

copy와 xcopy의 차이점을 간단히 요약하면 다음과 같다.

copy

다른 한 위치에서 하나 이상의 파일을 복사한다.
옵션이 제한적이며, 디렉토리 구조 복사 기능이 없다.

xcopy

하위 디렉토리를 포함하여 파일 및 디렉토리를 복사한다.
디렉토리 구조를 복사할 수 있다.
옵션을 사용하여 복사 작업을 제어할 수 있다.

간단히 말하면, xcopy는 copy에 옵션이 더 붙은 업그레이드된 형태로 이해해도 된다.

속도 차이

일반적으로 copy가 xcopy보다 빠르다.

copy 명령어는 단일 파일 복사하는 데 최적화되어 있다.

때문에 단일 파일이나 적은 수의 파일을 복사할 때 오버헤드가 적게 발생한다.

사용 용도

간단한 작업을 할 경우

작은 파일 및 단일 파일을 복사할 경우에는 copy 명령어가 더 빠르기 때문에 효율적이다.

대량의 파일이나 디렉토리 구조를 복사할 경우

대규모 파일 복사 작업에서는 xcopy 명령어가 더 효율적이다.

xcopy 명령어는 대량의 파일을 처리하고 디렉토리 구조를 유지하며 복사하는데 설계되어 있다.

또한, 다양한 옵션을 통해 복사 작업을 세밀하게 조정할 수 있기 때문에 전체적인 작업 속도 및 효율성이 높다.

참고

MSSQL - 저장 프로시저 문자열 검색하기, 프로시저 내용 조회하기 (시스템 뷰 활용)

luvris2 — Thu, 23 May 2024 12:55:31 +0900

SQL Server에서 저장 프로시저의 내용을 검색하는 방법에는

주로 시스템 뷰인 sys.procedures와 sys.sql_modules를 사용한다.

시스템 뷰, 시스템 카탈로그 뷰란?

우선 시스템 뷰에 대해 간단히 설명하고 넘어가보자.

시스템 뷰란 데이터베이스와 관련된 다양한 메타데이터를 뷰 유형으로 제공한다.

이 뷰들은 데이터베이스의 구조, 설정, 상태 등을 조회할 수 있는 정보를 제공하고,

데이터베이스 관리자가 시스템을 모니터링하고 유지 관리하는데 도움을 주는 기능을 한다.

[참고] 뷰에 대한 이해가 어렵다면, 아래의 페이지를 참고하는 것을 추천한다.

MSSQL - View - 뷰의 개념과 사용 방법, 분할 뷰 사용법

저장 프로시저의 정보를 확인하기 위한 시스템 뷰는?

저장 프로시저의 내용을 검색하려면 시스템 뷰인 sys.procedures와 sys.sql_modules를 사용한다고 언급했다.

각 시스템 뷰의 역할을 알아보면 다음과 같다.

sys.procedures: 저장 프로시저에 대한 정보를 제공한다.
sys.sql_modules: 저장 프로시저, 함수, 트리거 등의 정의를 포함한 정보를 제공한다.

즉, sys.procedures를 통해 프로시저의 이름을 확인하고,

sys.sql_modules를 통해 프로시저에 정의된 정보를 확인할 수 있다.

저장 프로시저 내용 찾기 쿼리

SELECT p.name AS ProcedureName, -- 프로시저 이름
       m.definition AS ProcedureDefinition -- 프로시저 정의 내용
FROM sys.procedures AS p
INNER JOIN sys.sql_modules AS m
    ON p.object_id = m.object_id
WHERE m.definition LIKE '%검색내용%'

저장 프로시저의 정의된 내용 확인

저장 프로시저의 내용을 보려면 sp_helptext를 이용하면 된다.

EXEC sp_helptext '프로시저명';

프로시저명을 입력하면, 해당 프로시저에 정의된 내용이 조회된다.

그 외 저장 프로시저 관련 포스팅

개념

사용법 : MS-SQL

사용법 : MySQL

MySQL - 프로시저 문법(생성, 수정, 삭제, 호출), 프로시저 확인, 사용 예제

#mssql #sql server #stored procedure #search #text

SQL - WHERE 1=1 사용 이유에 대해 알아보자 (+ WHERE 1=2 사용 이유)

luvris2 — Tue, 21 May 2024 10:35:14 +0900

개요

가끔 SQL 쿼리를 보면 WHERE절 맨 앞에 1=1이 있는 것을 볼 수가 있다.

SELECT * FROM t1 WHERE 1=1
	AND col1 = 'eunbyeol'

처음 볼 때에는 이게 무엇인가 싶었는데,

의미를 알고 사용하면 오히려 더 편하게 쿼리를 작성할 수도 있게 된다.

오늘은 WHERE 1=1을 왜 사용하는지에 대한 사용 이유에 대해 알아보도록 한다.

WHERE 1=1 사용 이유, 왜 사용할까?

동적 쿼리 조건 구성의 단순화

결론부터 말하자면, WHERE 1=1 은 주로 동적 쿼리를 작성할 때 많이 사용한다.

특정 조건에 따라 동적으로 추가되거나 제거되는 조건절을 위한 기본 쿼리 구조로 많이 사용된다.

SELECT * FROM t1 WHERE 1=1

위의 예시 쿼리는 동적 쿼리의 기본 구조를 심플하게 나타낸 것이다.

이 구조에서 프로그래머는 필요에 따라 AND 또는 OR 연산자를 사용하여

조건을 추가하면 쿼리를 훨씬 더 수월하게 작성할 수 있다.

SELECT * FROM t1 WHERE 1=1
-- 조건에 따라 조건식을 AND 또는 OR 로 추가해주자
    AND col1 = 'eunbyeol'
    AND col2 = 'incheon'

쿼리 조건의 일관성 유지

동적 쿼리에서 상황에 따라 쿼리가 다르게 작동되는 것은 당연하다.

하지만 외부에서 주어진 정해지지 않는 값을 통해 여러 가지의 쿼리를 실행하려면 그에 맞게 조건을 확인해야 할 쿼리의 수도 길어진다. 이때, 동적 쿼리의 기본 구조를 설정한 후 조건에 따라 조건 쿼리를 덧붙이는 식으로 쿼리를 짜면

상황에 따라 작성되는 쿼리의 일관성도 유지되고 잠재적 오류를 피할 수 있다.

아래의 예시 쿼리를 봐보자.

이 쿼리는 외부에서 받은 값을 통해 조건에 따라 쿼리를 실행시키는 프로시저이다.

조건에 따라 작성되는 쿼리는 일관적으로 AND 조건으로만 작성되었다.

프로시저로 들어온 값이 1일 경우, col1 컬럼에 은별이라는 데이터를 조회하고,
프로시저로 들어온 값이 2일 경우, col2 컬럼에 인천이라는 데이터를 조회한다.

[참고] 해당 프로시저는 예시를 위한 쿼리이며, MS-SQL(SSMS)을 기반으로 작성하였다.

/* 테스트 프로시저
*	파라미터에 전달 받은 값으로 특정 쿼리를 실행하는 프로시저
*	외부에서 받는 값은 숫자 1 또는 2로 한정
*/
CREATE PROC test
	@val INT -- 외부에서 전달 받는 값
AS BEGIN
	-- 동적 쿼리 기본 구조 설정
    DECLARE @sql NVARCHAR(MAX)
    SET @sql = 'SELECT * FROM t1 WHERE 1=1'

	-- 조건에 따라 쿼리 작성
	IF @val = 1
    		SET @sql = @sql + ' AND col1 = ''eunbyeol'''
   	ELSE IF @val = 2
    		SET @sql = @sql + ' AND col2 = ''incheon'''
        
    -- 쿼리 실행
    EXEC sp_executesql @sql
END

쿼리 디버깅 및 유지보수성 향상

동적 쿼리를 작성할 때 많이 사용하기도 하지만, 디버깅 및 유지보수를 위해서도 많이 사용한다.

WHERE절에 조건절을 위한 기본 쿼리 구조를 구성(예를 들어 1=1) 해두지 않고 쿼리를 작성하다 보면

생각보다 많이 조건절의 AND 혹은 OR을 지우고 쓰고를 반복하며 쿼리를 작성할 때가 있다.

이런 반복 작업이 쿼리를 계속 수정하다 보면 여간 귀찮은 게 아니다.

이는 쿼리를 보면 이해가 쉽다.

아래의 쿼리는 은별, 인천에 맞는 조건의 데이터를 조회하는 쿼리이다.

SELECT * FROM t1
WHERE 
	col1 = 'eunbyeol'
    AND col2 = 'incheon'

여기서 디버깅을 위해 여러 조건을 살펴봐야 할 때,

하나의 조건을 주석 처리하면서 쿼리를 확인해 본다는 시나리오를 작성해 보자.

그렇다면 내가 수정해야 될 부분은 조건절의 특정 조건만 주석처리하는 것이 가장 빠를 것이다.

SELECT * FROM t1
WHERE 
	-- col1 = 'eunbyeol'
    col2 = 'incheon' -- AND 키워드 삭제
    
 /* 혹은 */
 
SELECT * FROM t1
WHERE 
	col1 = 'eunbyeol'
    -- AND col2 = 'incheon'

위와 같이 조건을 주석 처리하여 쿼리를 실행할 때마다

AND 또는 OR 키워드가 있거나 없는 조건은 때때로 지우거나 오히려 덧붙여서 작성해야 될 때가 있다.

이는 간단하게도 WHERE 1=1을 써주면서 한결 더 작성이 쉬워질 수 있다.

굳이 이렇게까지 하나 싶지만, 의외로 회사 데이터베이스 프로시저에 많이 녹여져 있다.

생각보다 개발자들은 귀찮은걸 매우 싫어하니까 말이다.

SELECT * FROM t1
WHERE 1=1
	-- AND col1 = 'eunbyeol'
    AND col2 = 'incheon'
    
/* 혹은 */
    
SELECT * FROM t1
WHERE 1=1
	AND col1 = 'eunbyeol'
    -- AND col2 = 'incheon'

WHERE 1=1 쿼리 실행 속도, 데이터베이스 과부하 여부는?

대부분의 SQL 쿼리 최적화 엔진(옵티마이저)은 WHERE 1=1 조건을 무시한다.

1=1은 즉 항상 참일 수밖에 없기 때문에 쿼리의 논리적 실행 계획에서 무의미한 조건으로 처리하기 때문이다.

그래서 불필요한 조건을 제거하고 실제 필요한 조건만으로 실행 계획을 생성하기 때문에

데이터베이스 성능에 영향을 거의 미치지 않는다.

단, 매우 복잡한 쿼리거나 데이터가 매우 많은 데이터베이스일 경우에는

추가적인 조건 처리로 인해 발생하는 오버헤드가 미미하게 성능저하를 일으킬 수도 있다.

(대부분은 무시할 수 있는 정도라고 한다.)

WHERE 1=2 사용 이유, 얘는 어떨 때 사용될까?

데이터를 제외한 테이블 구조만 복사

테이블의 데이터를 제외하고 구조만 복사해야 할 때 주로 사용된다.

t1이라는 테이블은 col1, col2라는 컬럼이 존재하고, 약 천 개 정도의 데이터를 가지고 있다고 가정해 보자.

하지만 여기서 테이블의 구조만 복사하고 싶다면 아래와 같이 쿼리를 작성할 수 있다.

-- SQL Server, MS-SQL
SELECT * INTO new_t1 FROM t1 WHERE 1=2

이렇게 하면 t1 테이블의 데이터는 포함하지 않고 구조만 그대로 가진 빈 테이블 new_t1이 복사된다.

번외로 테이블 구조만 복사하는 방법은 출력 행의 제한을 주는 방법으로도 테이블을 복사할 수 있다.

개인적으로 테이블 구조 복사 할 때 출력행을 제한하는 것이 더 편하다.

이는 본인 편의에 맞게 사용하도록 하자.

-- SQL Server, MS-SQL
SELECT TOP 0 * INTO new_t1 FROM t1;

-- MySQL
CREATE new_t1 LIKE t1 LIMIT 0;

테스트 및 디버깅을 위한 쿼리 구문 검토

조건절의 WHERE 1=2를 테스트 및 디버깅 용도로도 사용될 수 있다.

첫 번째, 조회되는 데이터를 반환하지 않도록 보장하기 위한 용도로 사용된다.

이는 즉 테스트와 디버깅 과정에서 작성된 쿼리의 구조나 구문을 검토할 때 유용하다.

데이터가 많은 데이터베이스를 조회할 때에 부하가 일어날 수 있다.

작성된 쿼리의 데이터를 반환하지 않도록 하여 부하를 줄이고,

작성된 쿼리의 구조가 제대로 작성되었는지, 쿼리가 제대로 동작하는지를 검토할 수 있다.

두 번째, 특정 조건에서만 데이터를 반환하도록 제어할 수 있다.

아래의 쿼리는 WHERE 1=2를 이용하여 쿼리를 작성한 예시 코드이다.

AND로만 구성되어 있기 때문에 모든 조건이 맞는 데이터만 조회되도록 설계되어 있지만,

조건절의 시작 부분에 거짓(1=2)이 존재하기 때문에 데이터가 반환되지 않는다.

SELECT * FROM t1 WHERE 1=2
	AND col1 = 'eunbyeol'

쿼리는 그대로 두고 다른 조건을 테스트해야 될 때, 쿼리는 다음과 같이 작성될 수 있다.

SELECT * FROM t1 WHERE 1=2
	AND col1 = 'eunbyeol'
   	OR  col2 = 'incheon'

논리식에 의해 WHERE 1=2 AND col1 = 'eunbyeol'은 거짓이므로 조건을 조회하지 않는다.

반면, 추가된 OR col2 = 'incheon'은 둘 중 하나의 조건만 맞아도 되기 때문에

이후에 오는 특정 조건의 데이터를 손쉽게 제어할 수 있다.

이미 작성되어 있을 참(WHERE 1=1)의 논리식을 거짓(1=2)으로 바꾸어 처리하고,

쿼리는 수정 없이 그대로 둔 채 다른 조건을 추가하여 테스트 및 디버깅으로 데이터를 제어할 수 있다.

Kotlin, Spring Boot - 코프링 시작하기, 페이지에 HelloWorld 출력하기 (인텔리제이, JDK 설치 및 기본 개발 환경 구축)

luvris2 — Wed, 8 May 2024 16:09:51 +0900

개발 환경 개요

Java Version : Open JDK 21
Gradle 8.5
Spring Boot 3.2.5
Port Number : 8080
IDE : IntelliJ Community Edition

참고 깃 리지토리

포스팅에서 다룬 프로젝트는 아래의 깃허브 주소에서 다운로드 가능합니다.

https://github.com/luvris2/kotlin-spring-boot-example
하위 디렉토리 : 01_helloworld

GitHub - luvris2/kotlin-spring-boot-example

Contribute to luvris2/kotlin-spring-boot-example development by creating an account on GitHub.

github.com

개발 환경 구축

JDK 설치

코틀린은 자바(JVM) 기반이기 때문에 자바가 설치되어 있어야 한다.

OpenJDK에서 JDK 21을 다운로드 받아 설치하였다.

이 프로젝트는 JDK 21을 기반으로 할 것이기 때문이다.

https://jdk.java.net/21/

환경 변수 등록도 잊지 말고 꼭 해두자.

자바 JDK 환경 변수 등록 이미지

[참고] 자바 설치 및 환경 변수 등록하는 방법을 자세히 보려면 아래의 포스팅을 참고하자.

Java - 자바와 이클립스 설치하기, 환경 변수 설정하기

인텔리제이 설치

인텔리제이를 굳이 선택한 이유는 내가 편해서이다.

때문에 IDE툴은 자기가 편한 것을 선택하면 된다.

인텔리제이를 검색하고 jetbrains 홈페이지를 들어가서 다운로드를 받는다.

인텔리제이용 스프링부트도 있긴하지만, 학습용이므로 무료버전(커뮤니티 에디션)을 사용 할 것이다.

설치 시, 인텔리제이 경로를 환경변수에 등록하는 옵션을 체크해두는게 편하다.

[참고] 윈도우 사용자 빠른 다운로드 링크

https://www.jetbrains.com/ko-kr/idea/download/?section=windows

프로젝트 설정

프로젝트 생성

프로젝트는 편의상 spring boot initializer를 이용하여 생성한다.

https://start.spring.io/

스프링 부트를 사용할 코틀린 프로젝트 설정

Project : Gradle - Kotlin
Language : Kotlin
Spring Boot : 3.2.5
Dependencies
- Spring Web : 웹 개발을 위한 MVC 패턴, RESTful API, 웹 리소스 처리, 쿠키 및 세션 관리 등의 기능 존재, 웹 내장 서버 제공

코틀린 프로젝트 초기 설정

GENERATE를 누르면 다운로드가 시작된다.

다운로드 받은 파일의 압축을 풀고 인텔리제이에서 열어보자.

다운로드 받은 코틀린 프로젝트를 인텔리제이에서 불러온 화면

HelloWorld 페이지 출력해보기

HelloWorld 파일 생성하기

프로젝트 경로에서 src - main - kotlin - 패키지 경로로 이동하자.

패키지 경로에서 마우스 우클릭 - New - Kotlin Class/File 을 선택하여 파일을 생성한다.

파일 이름은 HelloWorldController로 명명하였다.

HelloWorld 내용 작성하기

웹 서버에 접속하면 HelloWorld라는 데이터를 반환해줄 내용을 구성해보자.

헬로월드를 보여줄 페이지 URL 경로는 /helloworld 로 해보자.

"HelloWorld"라는 문자열을 반환하기 위해서 두 개의 컨트롤러 중 하나 사용하여 구성할 수 있다.

[ Controller VS RestController 차이 비교해보기 ]

@Controller
- 전통적인 웹 사용 컨트롤러이다.
- 일반적으로 HTTP 요청에 대한 응답을 HTML 페이지로 반환한다.
- @GetMapping 어노테이션을 사용하여 특정 URL에 대한 GET 요청을 처리하는 메소드를 정의할 수 있다.
- @ResponseBody 어노테이션을 사용하여 RESTful 웹 서비스처럼 컨트롤러 메소드에 직접 JSON, XML 또는 기타 형식의 데이터를 반환할 때 사용한다.
@RestController
- RESTful 웹 서비스를 제공하는 컨트롤러이다.
- HTTP 요청에 대한 JSON 또는 XML 응답과 같은 RESTful 응답에 적합하도록 동작한다.
- @GetMapping 어노테이션을 사용하여 특정 URL에 대한 GET 요청을 처리하는 메소드를 정의할 수 있다.
- @RestController는 @ResponseBody를 포함하고 있으므로 따로 사용할 필요는 없다.

코틀링 스프링부트의 HelloWorld 찍먹(맛보기)이기 때문에 페이지를 따로 구축하지 않고 문자열만 반환하도록 한다.

단, 로컬에서 진행하며 포트 번호는 따로 변경하지 않고 진행한다.

두 개의 컨트롤러에서 본인이 사용하기에 편한 것을 사용해보자.

@Controller를 사용할 경우

// HelloWorldController.kt
package com.eunbyeol.helloworld

import org.springframework.stereotype.Controller
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.ResponseBody

@Controller
class HelloWorldController {
    @GetMapping("/helloworld") // 해당 URL GET 요청 메소드 정의
    @ResponseBody // RESTful HTTP
    fun hello(): String {
        return "Hello, World!" // Hello World 문자열 반환
    }
}

@RestController를 사용할 경우

// HelloWorldController.kt
package com.eunbyeol.helloworld

import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RestController

@RestController // RESTful 컨트롤러
class HelloWorldController {
    @GetMapping("/helloworld") // 해당 URL GET 요청 메소드 정의
    fun hello(): String {
        return "Hello, World!" // Hello World 문자열 반환
    }
}

서버 실행 및 HelloWorld 페이지 확인하기

내장 웹 서버 시작하기

스프링 부트는 작성한 애플리케이션 파일을 실행할 때 자체적으로 웹 서버를 시작한다.

때문에 따로 웹 서버를 설정하거나 시작할 필요없이 실행만 해주면 된다.

메인 파일(~~~Application.kt)로 이동하자.

상단 메뉴에서 Run - Run '~~~Application.kt'을 눌러 애플리케이션을 실행한다.

스프링부트 애플리케이션 실행 경로 이미지

그러면 인텔리제이 아랫 부분에 메시지가 생성된다.

아래와 같이 뜨고 메시지가 쭈욱 생성된다면 웹 서버가 성공적으로 실행된 것이다.

인텔리제이에서 Spring Boot 웹 서버 실행 화면

웹 서버가 실행되었으니 로컬에 접속해보자.

웹 서버 기본 포트는 8080을 사용한다.

http://localhost:8080/

Whitelabel Error Page라고 출력된다. 이는 에러가 아니다.

위의 내용에서 HelloWorldController.kt 파일에서 매핑되는 GET 주소를 /helloworld로 지정하였다.

현재 웹 서버에서는 /helloworld 를 제외하고 다른 URL 주소는 존재하지 않기 때문에 아무런 페이지도 출력되지 않는다.

기본 URL에 우리는 따로 설정한게 없으니 아무것도 출력되지 않는 것이 당연하다.

스프링부트 로컬 접속 화면

이제 /helloworld 로 이동해보자.

http://localhost:8080/helloworld

페이지가 정상적으로 잘 출력됨을 확인할 수 있다.

코틀린 스프링부트, Hello World 페이지 화면

SQL - LIKE 조건에 와일드카드 문자 자체를 검색에 포함하기

luvris2 — Wed, 1 May 2024 00:05:24 +0900

개요

테이블에 다음과 같은 데이터가 존재한다.

테이블 예시 데이터

1, 'eunbyeol'
2, 'e_nbyeol'
3, 'e__byeol'

나는 'e_nbyeol' 데이터를 like 키워드로 조회하고 싶다.

SELECT * FROM t1 WHERE name LIKE 'e_nbyeol'

하지만 위와 같이 쿼리를 작성하면 원하는 데이터가 조회되지 않는다.

LIKE 조회 결과 화면

생각해 보니 '_' 문자열은 와일드카드 문자열로 모든 문자를 대체한다.

때문에 다음과 같이 쿼리를 작성하면 예시 데이터의 모든 데이터가 조회된다.

SELECT * FROM t1 WHERE name LIKE 'e_%'

LIKE 조회 결과 화면

와일드카드 문자열을 포함하여 문자열을 찾으려면 어떻게 해야 할까?

이 글은 와일드카드 문자를 검색하기 위해 작성되었다.

LIKE 조건자 ESCAPE 구문

설명

LIKE 조건절에 ESCAPE 구문을 사용하여 모든 문자를 표현할 수 있다.

와일드카드 문자나 이스케이프 문자를 사용할 때 발생할 수 있는 혼동을 방지할 수 있다.

이스케이프 문자는 일반적으로 백슬래시(\)를 사용한다.

즉, 와일드카드 문자인 '%' 혹은 '_' 등을 원본 문자열로 표현할 수 있다는 것이다.

구문

SELECT
	*
FROM
	t1
WHERE
	name LIKE '\abc' {escape '\'} -- {} 중괄호는 생략해도 무방

데이터가 '\abc'인 문자를 조회한다.

사용 방법 및 예시(샘플) 쿼리

다음 데이터에서 'e_nbyeol' 데이터 조회하기

1, 'eunbyeol'
2, 'e_nbyeol'
3, 'e__byeol'

SELECT
	*
FROM
	t1
WHERE
	name LIKE 'e\_nbyeol%' escape '\'

LIKE 조건에 와일드카드 문자 포함 검색 결과

만약 이스케이프 구문이 없다면, 와일드카드 문자로 인해 'eunbyeol', 'e_nbyeol' 데이터가 조회된다.

데이터에서 'e_ _byeol' 데이터 조회하기

SELECT
	*
FROM
	t1
WHERE
	name LIKE 'e\_\_byeol%' escape '\'

LIKE 조건에 와일드카드 문자 2개 포함 검색 결과

만약 이스케이프 구문이 없다면, 와일드카드 문자로 인해 'eunbyeol', 'e_nbyeol', 'e_ _byeol' 모든 데이터가 조회된다.

편법 사용하기 (replace)

조회해야 할 문자 조건이 많을 경우,

일일이 LIKE 검색을 OR 연산시켜서 쿼리를 작성하기는 솔직히 너무 귀찮다.

그럴 경우에는 IN 구문을 사용하여 한꺼번에 처리하기 위해 편법을 사용하였다.

REPLACE로 특정 문자열로 바꿔서 찾아보는 방법도 나쁘지 않다.

단, 와일드카드를 다른 문자열로 변경할 경우,

다른 데이터와 데이터 중복이 되진 않은지 확인해 보고 사용하는 것을 추천한다.

[찾는 문자열 예시]

SELECT
	col1
FROM
	t1
WHERE
	REPLACE(col1, '_', '-') IN ('1-1', '1-2', '1-3')

SQL - LIKE 와일드 카드 사용 가이드(%, [], ^, _) 및 예시 샘플 코드

luvris2 — Tue, 30 Apr 2024 13:56:08 +0900

와일드카드란? 와일드카드 문자란? (WildCard)

와일드카드는 패턴 매칭을 위해 사용되는 문자
패턴에 일치하는 문자열을 효과적으로 검색하거나 필터링하기 위해 사용
SQL에서 주로 WHERE 절의 LIKE 연산자와 함께 사용
여러 가지 와일드카드 문자(%, [], ^, _)가 존재
즉, 데이터를 더 쉽게 검색하여 원하는 결과를 얻기 위한 목적으로 사용

와일드카드 : % (백분율 문자)

% : 하나 이상의 일치하는 문자 찾기

개념

0개 이상의 문자를 나타낸다.

즉, 임의의 문자열을 대체할 수 있다.

예를 들어, 'a%'는 'a'로 시작하는 모든 문자열을 나타낸다.

사용 방법

'e%' : 문자 'e'로 시작하는 모든 문자열을 나타낸다.

'%e' : 문자 'e로 끝나는 모든 문자열을 나타낸다.

'%e%' : 문자 'e'가 중간에 포함되는 모든 문자열을 나타낸다.

'e%l' : 문자 'e'로 시작하고 'l'로 끝나는 모든 문자열을 나타낸다.

예시

와일드카드 %를 설명하기 위한 예시 테이블 이미지

'cheon'으로 끝나는 문자열을 like 조회해보기

SELECT
	*
FROM
	t1
WHERE
	address LIKE '%cheon'

와일드카드 %를 사용하여 like 조회한 테이블 결과

와일드카드 : [] (일치하는 문자)

[] : 대괄호 안에 있는 문자 중 하나 이상의 일치하는 문자 찾기

개념

대괄호 안에 있는 문자 중 하나를 나타낸다.

대괄호 안에 있는 어떤 문자든 해당 자리에 올 수 있다.

예를 들어, 't[ae]st'는 'tast'와 'test' 두 문자열과 일치한다.

사용 방법

'[abc]' : 단일 문자를 매칭하는 방법으로, 'a', 'b', 'c' 중 하나와 일치하는 문자열을 나타낸다.

'[a-z]' : 범위를 지정하여 매칭하는 방법으로, 대괄호 안에 두 문자 사이에 하이픈(-)을 사용하여 문자 범위를 지정할 수 있다. 알파벳 소문자 a부터 z까지 일치하는 문자열을 나타낸다.

'[a-zA-Z0-9]' : 여러 조합을 사용하여 매칭하는 방법으로, 영어 소문자와 대문자, 숫자 중 하나와 일치하는 문자열을 나타낸다.

예시

와일드카드 []를 설명하기 위한 예시 테이블 이미지

'i', 's'로 시작하는 문자열을 like 조회해보기

SELECT
	*
FROM
	t1
WHERE
	address LIKE '[is]%'

와일드카드 []를 사용하여 like 조회한 테이블 결과

와일드카드 : [^] (일치하지 않는 문자)

[^] : 대괄호 안에서 문자와 불일치하는 문자 찾기

개념

대괄호 안에서 ^를 사용하면 해당 문자를 제외한 나머지 문자를 나타낸다.

예를 들어, '[^0-9]'는 숫자가 아닌 문자와 일치하는 문자열을 찾는다.

사용 방법

'[^0-9]' : 숫자를 포함하지 않는 문자열을 나타낸다.

'[^0-9]abc' : 숫자를 포함하지 않고 'abc'가 포함된 문자열을 나타낸다.

예시

와일드카드 [^]를 설명하기 위한 예시 테이블 이미지

문자 중간에 'eo'가 포함되며, 'eo' 뒤에 'u' 문자열이 포함되지 않는 문자열을 like 조회해보기 (eou는 검색하지 않기)

SELECT
	*
FROM
	t1
WHERE
	address LIKE '%eo[^u]%'

와일드카드 [^]를 사용하여 like 조회한 테이블 결과

와일드카드 : _ (한 문자와 일치)

_ : 하나의 문자가 어떠한 문자든 상관없이 문자열 찾기

개념

하나의 문자를 나타낸다.

즉, 어떠한 문자든 하나의 문자에 된다.

예를 들어, 't_st'는 'test', 'tast', 'tost' 등과 일치한다.

사용 방법

'c_t' : c와 t로 된 세 글자 문자에서 중간 문자는 상관없이 문자열을 조회한다. 'cat', 'cAt', 'cut' 등, 어떠한 문자든 하나의 문자로 대응한다.

'_ _34' : 앞 두 글자가 어떠한 문자가 와도 34가 포함된 네 글자의 문자열을 조회한다. '1234', 'AB34' 등을 일치하지만 '234'를 일치시키진 않는다.

예시

와일드카드 [_]를 설명하기 위한 예시 테이블 이미지

문자 중간에 'e'로 시작하고 'u'로 끝나는 세 글자 문자열을 like 조회해보기 (exu에서 x는 어떤 문자가 와도 상관하지 않음)

SELECT
	*
FROM
	t1
WHERE
	address LIKE '%e_u%'

와일드카드 [_]를 사용하여 like 조회한 테이블 결과

참고

Flutter/Dart - 채팅 앱 만들기(4) - 앱에서 소켓 서버와 통신하여 채팅 기능 구현하기

luvris2 — Tue, 23 Apr 2024 12:49:34 +0900

개요

웹 소켓 서버에 대한 기능은 이전 포스팅으로 분리하였으므로,

이번에는 채팅 앱 클라이언트에서 웹 소켓 서버와 통신하고

실제로 실시간 채팅이 이루어지는 기능을 상호작용할 수 있도록 해보자.

[ 시리즈 포스팅 내용 보기 ]

이번 포스팅에서는 아래와 같은 내용을 다룬다.

클라이언트에서 메시지를 보내는 방법

단순히 모든 클라이언트에게 메시지를 보내는 방법
특정 클라이언트에게 메시지를 보내는 방법
- 포스팅에서는 '귓속말'이라는 기능으로 구현하였다.

[ 각각의 클라이언트 1, 2, 3의 유저가 접속하여 메시지를 나누고 1과 2의 유저가 단 둘만의 메시지를 전달하는 예시 화면 ]

포스팅에서 다루는 플러터 채팅 앱은 깃허브에서 다운로드 할 수 있다.

https://github.com/luvris2/flutter_chatting_app

GitHub - luvris2/flutter_chatting_app

Contribute to luvris2/flutter_chatting_app development by creating an account on GitHub.

github.com

웹소켓 클라이언트

구조 설계

[ 파일 구조 ]

main.dart
- 플러터 앱이 실행되는 메인 함수를 포함하는 파일
- 사용자의 식별을 위해 닉네임을 입력 받아 채팅 페이지로 이동하는 페이지를 포함하고 있다.
socket.dart
- 웹 소켓 서버에 연결하고, 소켓 서버 데이터를 송수신하는 기능을 포함하고 있다.
chat 폴더
- chat_main.dart
  - 채팅 페이지를 구성할 메인 뼈대 역할을 하는 파일
  - 해당 페이지에서 채팅 내용을 입력할 영역과 채팅 내용을 보여줄 영역을 지정한다.
  - 클라이언트로 전달 받은 데이터를 하위 요소들에게 데이터를 전달하는 역할을 한다.
  - 또한, setState 함수를 하위 요소로 전달하여 상태값을 각 클래스와 공유한다.
- chat_area.dart
  - 채팅 내용을 보여줄 영역을 구성하는 파일
  - 서버에서 전달 받은 데이터를 토대로 채팅 메시지 내용을 구성하는 역할을 한다.
  - 메시지의 내용은 생성자를 통해 chat_main.dart로부터 전달 받는다.
- input_text_area.dart
  - 채팅 내용을 입력하는 기능으로 구성된 파일
  - 작성한 메시지 내용을 사용자와 상호작용하여 서버로 요청하는 역할을 한다.
  - 사용자의 이름과 메시지의 내용을 생성자를 통해 chat_main.dart으로부터 전달받고, 해당 값을 전달받은 setState(포스팅에서는 updateMessage로 지정) 함수를 통해 값을 공유한다.

[ 연결 구조 ]

main.dart
- chat_main.dart
  - chat_area.dart
  - input_text_area.dart
    - socket.dart

기능 구현

main.dart (MainPage)

메인 함수 (main)

메인 함수를 통해 메인 파일의 메인 페이지를 처음으로 보여주도록 한다.

void main() async {
  runApp(
    const MaterialApp(
      home: MainPage(), //ChatMainPage(),
    ),
  );
}

메인 페이지 (MainPage)

사용자의 이름을 입력 받고, 확인 버튼을 누르면 채팅 페이지로 이동하는 기능을 하는 페이지
텍스트 에디팅 컨트롤러로 입력 받은 사용자 이름을 chat_main.dart 파일의 ChatMainPage 클래스로 값을 넘겨준다.

class MainPage extends StatelessWidget {
  const MainPage({super.key});

  @override
  Widget build(BuildContext context) {
    // 텍스트필드 컨트롤러
    TextEditingController textEditingController = TextEditingController();

    return Scaffold(
      body: Center(
        child: Container(
          width: 250,
          height: 200,
          decoration: BoxDecoration(
            borderRadius: BorderRadius.circular(20),
            border: Border.all(
              color: Colors.grey,
              width: 2,
            ),
          ),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              // 유저 이름 입력
              SizedBox(
                width: 200,
                child: TextField(
                  controller: textEditingController,
                  decoration: const InputDecoration(
                    label: Center(child: Text("사용자 이름 입력")),
                  ),
                  textAlign: TextAlign.center,
                ),
              ),
              ElevatedButton(
                onPressed: () {
                  String txtValue = textEditingController.text;
                  txtValue = txtValue.trim();
                  if (txtValue != "") {
                    Navigator.push(context,
                        MaterialPageRoute(builder: (context) {
                      return ChatMainPage(
                        username: txtValue,
                      );
                    }));
                  }
                },
                child: const Text("확인"),
              )
            ],
          ),
        ),
      ),
    );
  }
}

socket.dart (FlutterWebSocket)

클라이언트가 웹 소켓 서버에 연결하고, 메시지 데이터를 보내기 위한 클래스를 정의한다.

웹 소켓 서버에 연결

웹 소켓 서버를 연결하기 위한 함수 getSocket을 정의한다.

반환 값으로 연결된 소켓 인스턴스를 반환한다.

  List messageList = [];
  String SERVER = "ws://192.168.10.103:4001";

  // 웹 소켓 서버 연결
  Future<WebSocket> getSocket() async {
    WebSocket socket = await WebSocket.connect(SERVER);
    return socket;
  }

소켓 서버에 데이터 송신

소켓 서버에 데이터를 보낼 함수 addMessage를 정의한다.

해당 함수에서는 JSON 데이터로 내보내기 위해 맵 형식으로 구성한다.

웹 소켓 서버에 데이터를 보내는 구성 형식은 다음과 같다.

username : 서버로 보낼 식별 가능한 유저의 이름
message : 서버로 보낼 메시지 내용
type : 서버에서 기능을 구행하기 위한 유형
- 유형에는 3가지로 나누었다.
- init : 클라이언트 접속 정보 초기화, 맨 처음 소켓 서버에 연결할 때 접속 정보를 넘겨주기 위해 사용한다.
- all : 모든 클라이언트에게 메시지 전송
- whisper : 특정 클라이언트에게 메시지 전송, '|' 기호를 구분자로 처리하여 뒤의 문자열을 특정 클라이언트의 정보를 기입하도록 하였다.

  // 소켓 서버에 데이터 송신
  addMessage(socket, username, message, type) {
    Map<String, dynamic> data = {
      'username': username,
      'message': message,
      'type': type,
      // [type]
      //    - init    :   클라이언트 접속 정보 초기화
      //    - all     :   모든 클라이언트에게 메시지 전송
      //    - whisper|username :   특정 클라이언트에게 메시지 전송
    };
    print("[socket.dart] 메시지 전송 : $username : $message");
    socket?.add(jsonEncode(data));
  }

chat_main.dart (ChatMainPage)

상태 값을 공유할 변수 및 함수 선언

  // 메시지 내용을 저장하는 변수
  List messageList = [];

  // 메시지 내용을 setState 함수를 통해 상태를 업데이트하는 함수
  void setStateMessage(data) {
    print("[chat_main.dart] (setStateMessage) 업데이트 할 값 : $data");
    setState(() => messageList.add(data));
  }

채팅 영역과 메시지 내용 입력 영역 구분 및 각 생성자 데이터 할당

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Column(
          children: <Widget>[
            // 메시지 내용 표시 영역
            ChatArea(
              messageList: messageList,
            ),
            // 메시지 입력 영역
            InputTextArea(
              username: widget.username,
              messageList: messageList,
              updateMessage: setStateMessage,
            )
          ],
        ),
      ),
    );
  }

input_text_area.dart (InputTextArea)

웹소켓 서버 연결 및 설정

웹소켓 서버를 연결하기 위해 위에서 정의한 FlutterWebSocket 클래스를 이용하여 소켓 서버에 연결한다.

위젯이 초기화 될 때(initState) 소켓 서버를 연결하기 위해 FlutterWebSocket 클래스의 getSocket() 메서드를 이용하여 소켓 서버를 연결한다.
소켓 인스턴스를 반환받은 소켓의 listen 함수를 이용하여 메시지를 수신 받도록 한다.
서버에서 메시지를 수신 받을 경우, 메시지의 값을 업데이트한다. (setState)
- updateMessage 함수는 상위 요소로 전달한 값을 setState 함수를 통해 상태 값을 업데이트 하는 역할을 한다.

// 웹소켓 할당을 위한 변수
  final FlutterWebSocket flutterWebSocket = FlutterWebSocket();
  WebSocket? socket;

  @override
  void initState() {
    super.initState();

    createSocket(); // 웹소켓 서버 연결하기
  }

  // 서버 연결
  void createSocket() async {
    try {
      socket = await flutterWebSocket.getSocket();

      // 클라이언트 초기 설정 (서버측 클라이언트 정보 알림용 메시지 전송)
      flutterWebSocket.addMessage(socket, widget.username, "", "init");

      socket?.listen((data) {
        print("[input_text_area.dart] (createSocket) 서버로부터 받은 값 : $data");
        setState(() {
          widget.updateMessage(data);
        });
      });
    } catch (e) {
      print("[input_text_area.dart] (createSocket) 소켓 서버 접속 오류");
    }
  }

채팅앱 클라이언트 전체 소스 코드

main.dart

import 'package:flutter/material.dart';
import 'chat/chat_main.dart';

void main() async {
  runApp(
    const MaterialApp(
      home: MainPage(), //ChatMainPage(),
    ),
  );
}

class MainPage extends StatelessWidget {
  const MainPage({super.key});

  @override
  Widget build(BuildContext context) {
    // 텍스트필드 컨트롤러
    TextEditingController textEditingController = TextEditingController();

    return Scaffold(
      body: Center(
        child: Container(
          width: 250,
          height: 200,
          decoration: BoxDecoration(
            borderRadius: BorderRadius.circular(20),
            border: Border.all(
              color: Colors.grey,
              width: 2,
            ),
          ),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              // 유저 이름 입력
              SizedBox(
                width: 200,
                child: TextField(
                  controller: textEditingController,
                  decoration: const InputDecoration(
                    label: Center(child: Text("사용자 이름 입력")),
                  ),
                  textAlign: TextAlign.center,
                ),
              ),
              ElevatedButton(
                onPressed: () {
                  String txtValue = textEditingController.text;
                  txtValue = txtValue.trim();
                  if (txtValue != "") {
                    Navigator.push(context,
                        MaterialPageRoute(builder: (context) {
                      return ChatMainPage(
                        username: txtValue,
                      );
                    }));
                  }
                },
                child: const Text("확인"),
              )
            ],
          ),
        ),
      ),
    );
  }
}

socket.dart

import 'dart:convert';
import 'dart:io';

class FlutterWebSocket {
  List messageList = [];
  String SERVER = "ws://192.168.10.103:4001";

  // 웹 소켓 서버 연결
  Future<WebSocket> getSocket() async {
    WebSocket socket = await WebSocket.connect(SERVER);
    return socket;
  }

  // 소켓 서버에 데이터 송신
  addMessage(socket, username, message, type) {
    Map<String, dynamic> data = {
      'username': username,
      'message': message,
      'type': type,
      // [type]
      //    - init    :   클라이언트 접속 정보 초기화
      //    - all     :   모든 클라이언트에게 메시지 전송
      //    - whisper|username :   특정 클라이언트에게 메시지 전송
    };
    print("[socket.dart] 메시지 전송 : $username : $message");
    socket?.add(jsonEncode(data));
  }
}

chat_main.dart

import 'package:flutter/material.dart';

import 'chat_area.dart';
import 'input_text_area.dart';

class ChatMainPage extends StatefulWidget {
  final String username;
  const ChatMainPage({super.key, required this.username});

  @override
  State<ChatMainPage> createState() => _ChatMainPageState();
}

class _ChatMainPageState extends State<ChatMainPage> {
  // 메시지 내용을 저장하는 변수
  List messageList = [];

  // 메시지 내용을 setState 함수를 통해 상태를 업데이트하는 함수
  void setStateMessage(data) {
    print("[chat_main.dart] (setStateMessage) 업데이트 할 값 : $data");
    setState(() => messageList.add(data));
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Column(
          children: <Widget>[
            // 메시지 내용 표시 영역
            ChatArea(
              messageList: messageList,
            ),
            // 메시지 입력 영역
            InputTextArea(
              username: widget.username,
              messageList: messageList,
              updateMessage: setStateMessage,
            )
          ],
        ),
      ),
    );
  }
}

chat_area.dart

import 'dart:convert';
import 'package:flutter/material.dart';

class ChatArea extends StatefulWidget {
  final List messageList;
  const ChatArea({super.key, required this.messageList});

  @override
  State<ChatArea> createState() => _ChatAreaState();
}

class _ChatAreaState extends State<ChatArea> {
  ScrollController scrollController = ScrollController();

  @override
  Widget build(BuildContext context) {
    // 리스트뷰에 메시지가 추가되면 스크롤을 가장 아래로 이동
    WidgetsBinding.instance.addPostFrameCallback((_) {
      scrollController.animateTo(scrollController.position.maxScrollExtent,
          duration: const Duration(milliseconds: 500), curve: Curves.ease);
    });

    return Expanded(
      child: ListView.builder(
        controller: scrollController,
        itemCount: widget.messageList.length,
        itemBuilder: (BuildContext context, int index) {
          // 추가된 메시지 내용
          print(
              "[chat_area.dart] (build) 추가된 메시지 내용 : ${widget.messageList[index]}");

          // JSON 문자열을 맵으로 변환
          Map<String, dynamic> data = jsonDecode(widget.messageList[index]);

          return Stack(
            children: [
              Text("${data['username']}"),
              Card(
                margin: const EdgeInsets.fromLTRB(0, 20, 0, 10),
                child: Padding(
                  padding: const EdgeInsets.fromLTRB(10, 5, 10, 5),
                  child: Text(data['message']),
                ),
              ),
            ],
          );
        },
      ),
    );
  }
}

input_text_area.dart

import 'dart:io';
import 'package:flutter/material.dart';
import '../socket.dart';

class InputTextArea extends StatefulWidget {
  final String username;
  final List messageList;
  final Function updateMessage;
  const InputTextArea(
      {super.key,
      required this.username,
      required this.messageList,
      required this.updateMessage});

  @override
  State<InputTextArea> createState() => _InputTextAreaState();
}

class _InputTextAreaState extends State<InputTextArea> {
  final TextEditingController _controller = TextEditingController();

  // 웹소켓 할당을 위한 변수
  final FlutterWebSocket flutterWebSocket = FlutterWebSocket();
  WebSocket? socket;

  @override
  void initState() {
    super.initState();

    createSocket(); // 웹소켓 서버 연결하기
  }

  // 서버 연결
  void createSocket() async {
    try {
      socket = await flutterWebSocket.getSocket();

      // 클라이언트 초기 설정 (서버측 클라이언트 정보 알림용 메시지 전송)
      flutterWebSocket.addMessage(socket, widget.username, "", "init");

      socket?.listen((data) {
        print("[input_text_area.dart] (createSocket) 서버로부터 받은 값 : $data");
        setState(() {
          widget.updateMessage(data);
        });
      });
    } catch (e) {
      print("[input_text_area.dart] (createSocket) 소켓 서버 접속 오류");
    }
  }

  // 메시지 보내기
  void sendMessage() {
    if (_controller.text.trim().isNotEmpty) {
      String message = _controller.text; // 메시지 내용
      String messageType = ""; // 메시지 타입

      // 귓속말 명령어 확인
      //    예) /w 사용자 내용
      //        - /w : 귓속말 명령어
      //        - 사용자 : 귓속말 보낼 사용자
      //        - 내용 : 귓속말 내용
      if (_controller.text.split(" ")[0] == "/w") {
        messageType = "whisper|${_controller.text.split(" ")[1]}";
        String excludeString =
            "${_controller.text.split(" ")[0]} ${_controller.text.split(" ")[1]}";

        message = "(귓속말)${_controller.text.replaceFirst(excludeString, "")}";
      }
      // 귓속말 명령어가 없으면 모두에게 메시지 보내기
      else {
        messageType = "all";
      }

      // 웹소켓 서버에 메시지 내용 전송
      flutterWebSocket.addMessage(
          socket, widget.username, message, messageType);

      _controller.clear();
    }
  }

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(8.0),
      child: Row(
        children: <Widget>[
          // 메시지 입력란
          Expanded(
            child: TextField(
              controller: _controller,
              decoration:
                  const InputDecoration(labelText: 'Enter your message'),
            ),
          ),
          // 전송버튼
          IconButton(
            icon: const Icon(Icons.send),
            onPressed: () => sendMessage(), // 메시지 보내기
          ),
        ],
      ),
    );
  }
}

Flutter/Dart - 채팅 앱 만들기(3) - 다트 웹 소켓 서버 기능 구현하기

luvris2 — Thu, 18 Apr 2024 16:08:09 +0900

개요

이전 포스팅에서 다뤘던 기능들과 플러터 앱의 UI를 결합하여,

이번에는 웹소켓 서버와 통신 하여 실제 실시간 채팅이 이루어지도록 기능을 구현해보자.

웹소켓과 채팅 기능의 이해를 돕기 위해 최대한의 최대한... 간소화 하였다.

UUID와 Shared Preference를 활용한 조금 더 정밀한 개인 메시지 전송 방법을 설명하려했지만,

그러면 포스팅의 내용이 너무 길어지고 복잡해질꺼 같아서 전부 다 뺐다.

프로젝트를 간단히 초기 설정된 닉네임으로만 통하여 메시지를 보내도록 수정하였다.

때문에 같은 닉네임을 사용한다면 사실상 1:1 개인 메시지의 기능이 아니게 되는 허점이 존재하지만 이해하길 바란다.

(이 기능을 잘 활용하면 특정 방에 접속한 유저들끼리 나눌 수 있는 '채팅방' 형태의 기능을 구현할 수도 있다.)

[ 시리즈 포스팅 내용 보기 ]

내용이 너무 길어지기 때문에 두 개의 포스팅으로 나눠서 작성하였다.

이번 포스팅에서는 아래와 같은 내용을 다룬다.

서버에 접속한 클라이언트 관리하는 방법

클라이언트의 초기 접속 시 기능 수행 방법
- 포스팅에서는 접속 시 사용자의 이름과 클라이언트의 정보를 서버에 저장한다.
클라이언트의 접속 종료 시 기능 수행 방법
- 포스팅에서는 접속 종료 시 서버에 저장된 목록에서 접속 종료한 클라이언트를 제거한다.

[ 각각의 클라이언트 1, 2, 3의 유저가 접속하여 메시지를 나누고 1과 2의 유저가 단 둘만의 메시지를 전달하는 예시 화면 ]

포스팅에서 다루는 플러터 채팅 앱은 깃허브에서 다운로드 할 수 있다.

https://github.com/luvris2/flutter_chatting_app

GitHub - luvris2/flutter_chatting_app

Contribute to luvris2/flutter_chatting_app development by creating an account on GitHub.

github.com

웹소켓 서버

통신 구조 설계

클라이언트의 데이터를 서버에서 받아 처리할 구조를 만들어보자.

포스팅에서의 서버는 클라이언트로부터 3가지의 정보를 받아 처리하도록 설계하였다.

[ 서버에서 클라이언트 접속 정보 저장에 필요한 요소 ]

클라이언트의 웹소켓 인스턴스
사용자의 닉네임

[ 서버에서 클라이언트의 요청 처리에 필요한 요소 ]

클라이언트의 웹소켓 인스턴스
클라이언트의 데이터
- 사용자의 닉네임
- 메시지 내용
- 데이터 분류 코드

기능 구현

변수 선언 및 초기화

서버에서 사용될 변수를 선언하고 초기화 한다.

사용될 변수는 서버가 구동될 호스트 주소와 포트 번호,

그리고 클라이언트 접속 목록을 관리할 리스트 타입의 변수이다.

/* 환경에 맞게 변경 */
String HOST = '192.168.10.103'; // 서버 호스트
int PORT = 4001; // 서버 포트
List<dynamic> clients = []; // 클라이언트 목록

서버 설정 및 생성

클라이언트가 접속할 웹소켓 서버를 생성해보자.

main 함수에서 서버를 설정하고 생성한다.

createServer 함수를 이용하여 생성된 HttpServer를 반환한다.

이러면 HttpServer가 생성된다.

(HttpServer는 이 후 클라이언트의 요청에 따라 웹 소켓으로 프로토콜을 업그레이드 한다.)

이후 수행될 clientConnections 함수는 밑에서 자세히 다룬다.

void main() async {
  // 서버 설정
  HttpServer server = await createServer();

  // 클라이언트 요청 및 메시지 처리
  clientConnections(server);
}

// 서버 생성
createServer() {
  print("서버가 생성되었습니다. $HOST:$PORT");
  return HttpServer.bind(HOST, PORT);
}

클라이언트 접속 처리

클라이언트가 HttpServer로 요청을 하면, 요청을 WebSocket으로 업그레이드하여 통신을 시도한다.

코드에서는 간단히 접속한 아이피 주소를 콘솔에 출력하였고,

이 후 클라이언트와 통신을 통해 상호작용할 임의의 함수인 webSocketActions 함수를 정의하여 기능을 수행하도록 한다.

클라이언트가 접속 할 경우 print를 통해 다음과 같은 메시지가 서버 콘솔에 출력된다.

예) 클라이언트 접속 : 192.168.10.103

// 클라이언트 요청 및 메시지 처리
clientConnections(HttpServer server) async {
  // 클라이언트 요청 비동기 처리
  await for (var req in server) {
    // HTTP 요청을 웹 소켓 프로토콜로 업그레이드
    await WebSocketTransformer.upgrade(req).then((WebSocket websocket) async {
      // 디버그용 클라이언트 식별 print
      print("클라이언트 접속 : ${req.connectionInfo!.remoteAddress.address}");

      // 클라이언트 통신
      await webSocketActions(websocket);
    });
  }
}

클라이언트 상호작용 처리

클라이언트와 상호작용을 하는 임의의 함수인 webSocketActions를 정의한다.

이 함수에서는 다음과 같은 기능을 수행하도록 설계하였다.

클라이언트 초기 접속 시 접속 정보 저장 (addClient 함수)
메시지 데이터 송수신 처리 (webSocketListen 함수)
클라이언트 연결 종료 시 접속 정보 삭제 (removeClient 함수)

// 클라이언트와 상호작용하는 함수
webSocketActions(WebSocket websocket) {
  // 클라이언트로 받은 데이터 메시지 처리
  websocket.listen((data) {
    // JSON 데이터 파싱
    var dataInfo = convertToJson(data);
    String messageType = dataInfo['type'].split("|")[0];

    // 초기 접속 시 클라이언트 접속 정보 저장
    if (messageType == "init") {
      addClient(websocket, dataInfo['username']);
    }
    // 연결되어 있는 클라이언트에게 보낼 데이터 송신 처리
    else {
      webSocketListen(websocket, data);
    }
  },
      // 클라이언트 연결 종료 시 서버 목록에 제거
      onDone: () {
    removeClient(websocket);
  },
      // 에러 처리
      onError: (e) {
    print("[server.dart] (webSocketActions) onError : $e");
  });
}

클라이언트 초기 접속 시 접속 정보 저장

webSocketActions 함수에서 수행되는 기능 중 하나로, addClient라고 함수명을 명명하였다.

접속한 클라이언트의 접속 정보를 사전에 정의한 리스트 타입의 변수인 clients 에 저장한다.

접속 정보는 클라이언트의 웹소켓 인스턴스 정보와 사용자가 지정한 닉네임으로 구성한다.

// 클라이언트 초기 접속 정보 저장
addClient(client, username) {
  print("클라이언트 접속 정보 : username($username)");
  clients.add([client, username]);
}

클라이언트측 메시지 데이터 송수신 처리

webSocketActions 함수에서 수행되는 기능 중 하나로, webSocketListen이라고 함수명을 명명하였다.

클라이언트측에서 받은 JSON 데이터를 파싱하여, 사전에 정의한 데이터 유형을 파악 한 후, 유형에 맞는 대상 클라이언트에게 메시지를 다시 보내는 역할을 한다. 클라이언트에서 보내는 데이터의 내용은 다음과 같다.

아래의 형식은 정해진 형식이 없기 때문에 개발자가 알아서 본인에 맞게 형식을 만들고,

소켓 서버에서는 정의한 형식에 맞게 처리 해주는 로직을 만들면 된다.

username : 사용자의 닉네임
message : 메시지 내용
type : 데이터 분류 코드
- init : 클라이언트 접속 정보 초기화
- all : 모든 클라이언트에게 메시지 전송
- whisper|username : 특정 클라이언트에게 메시지 전송, '|'(or) 기호를 구분자로 뒤에 위치하는 문자열로 특정 클라이언트를 지정한다.

// 클라이언트로 받은 데이터 메시지 처리
webSocketListen(WebSocket websocket, data) {
  // JSON 데이터 파싱
  print("클라이언트로부터의 메시지 : $data");
  var dataInfo = convertToJson(data);
  String messageType = dataInfo['type'].split("|")[0];

  for (var client in clients) {
    // 전체 사용자에게 메시지 보내기
    if (messageType == "all") {
      client[0].add(data);
    }
    // 귓속말 대상과 자신에게만 메시지를 보내기
    else if (messageType == "whisper") {
      String whisper = dataInfo['type'].split("|")[1];
      if (client[1] == whisper || client[1] == dataInfo['username']) {
        client[0].add(data);
      }
    }
  }
}

클라이언트 연결 종료 시 접속 정보 삭제

webSocketActions 함수에서 수행되는 기능 중 하나로, removeClient라고 함수명을 명명하였다.

서버에서 접속한 클라이언트들의 정보를 가지고 있는 리스트 변수인 clients 에서 접속을 종료한 클라이언트의 정보를 제거한다.

클라이언트를 식별하기 위해서 포스팅에서는 간단히 유저의 이름을 식별하여 유저 이름에 맞는 클라이언트의 정보를 리스트에서 제외하였다.

// 클라이언트 연결 종료 시 서버 목록에서 제거
removeClient(WebSocket websocket) {
  for (var i = 0; i < clients.length; i++) {
    var client = clients[i];
    if (client[0] == websocket) {
      print("클라이언트 접속 종료 : ${client[1]}");
      clients.removeAt(i); // 해당 클라이언트 목록에서 제거
      print("접속중인 클라이언트 목록 : $clients");
      break; // 클라이언트를 찾았으므로 반복문 종료
    }
  }
}

JSON 데이터 파싱 함수

클라이언트측에서 받은 JSON 데이터를 파싱하는 함수이다.

// JSON 데이터 파싱 함수
convertToJson(data) {
  Map<String, dynamic> converData = jsonDecode(data);
  return converData;
}

소켓 서버 전체 소스 코드

import 'dart:convert';
import 'dart:io';

String HOST = '192.168.10.103'; // 서버 호스트
int PORT = 4001; // 서버 포트
List<dynamic> clients = []; // 클라이언트 목록

void main() async {
  // 서버 설정
  HttpServer server = await createServer();

  // 클라이언트 요청 및 메시지 처리
  clientConnections(server);
}

// 서버 생성
createServer() {
  print("서버가 생성되었습니다. $HOST:$PORT");
  return HttpServer.bind(HOST, PORT);
}

// 클라이언트 요청 및 메시지 처리
clientConnections(HttpServer server) async {
  // 클라이언트 요청 비동기 처리
  await for (var req in server) {
    // HTTP 요청을 웹 소켓 프로토콜로 업그레이드
    await WebSocketTransformer.upgrade(req).then((WebSocket websocket) async {
      // 디버그용 클라이언트 식별 print
      print("클라이언트 접속 : ${req.connectionInfo!.remoteAddress.address}");

      // 클라이언트 통신
      await webSocketActions(websocket);
    });
  }
}

// 클라이언트 초기 접속 정보 저장
addClient(client, username) {
  print("클라이언트 접속 정보 : username($username)");
  clients.add([client, username]);
}

// 클라이언트 연결 종료 시 서버 목록에서 제거
removeClient(WebSocket websocket) {
  for (var i = 0; i < clients.length; i++) {
    var client = clients[i];
    if (client[0] == websocket) {
      print("클라이언트 접속 종료 : ${client[1]}");
      clients.removeAt(i); // 해당 클라이언트 목록에서 제거
      print("접속중인 클라이언트 목록 : $clients");
      break; // 클라이언트를 찾았으므로 반복문 종료
    }
  }
}

// 클라이언트와 상호작용하는 함수
webSocketActions(WebSocket websocket) {
  // 클라이언트로 받은 데이터 메시지 처리
  websocket.listen((data) {
    // JSON 데이터 파싱
    var dataInfo = convertToJson(data);
    String messageType = dataInfo['type'].split("|")[0];

    // 초기 접속 시 클라이언트 접속 정보 저장
    if (messageType == "init") {
      addClient(websocket, dataInfo['username']);
    }
    // 연결되어 있는 클라이언트에게 보낼 데이터 송신 처리
    else {
      webSocketListen(websocket, data);
    }
  },
      // 클라이언트 연결 종료 시 서버 목록에 제거
      onDone: () {
    removeClient(websocket);
  },
      // 에러 처리
      onError: (e) {
    print("[server.dart] (webSocketActions) onError : $e");
  });
}

// JSON 데이터 파싱 함수
convertToJson(data) {
  Map<String, dynamic> converData = jsonDecode(data);
  return converData;
}

// 클라이언트로 받은 데이터 메시지 처리
webSocketListen(WebSocket websocket, data) {
  // JSON 데이터 파싱
  print("클라이언트로부터의 메시지 : $data");
  var dataInfo = convertToJson(data);
  String messageType = dataInfo['type'].split("|")[0];

  for (var client in clients) {
    // 전체 사용자에게 메시지 보내기
    if (messageType == "all") {
      client[0].add(data);
    }
    // 귓속말 대상과 자신에게만 메시지를 보내기
    else if (messageType == "whisper") {
      String whisper = dataInfo['type'].split("|")[1];
      if (client[1] == whisper || client[1] == dataInfo['username']) {
        client[0].add(data);
      }
    }
  }
}

MS-SQL - NEWID() 함수의 랜덤 값 액세스에 관해서, 랜덤 값 중복 여부 트러블 슈팅

luvris2 — Wed, 17 Apr 2024 17:17:33 +0900

개요

MS-SQL(SQL Server) 에서는 NEWID() 함수를 이용하여 임의의 데이터를 조회할 수 있다.

예를 들면, 1부터 10까지의 숫자가 있을 경우 NEWID() 함수를 통해 1~10 사이의 임의의 값을 출력하여 조회할 수 있다.

-- 테이블 변수 생성
DECLARE @temp_table TABLE(
	num int
)

-- 테이블 변수에 1~10의 값 추가
DECLARE @i int = 1
WHILE @i <=10 BEGIN
	INSERT INTO @temp_table
		SELECT @i
        
	SET @i += 1
END

-- 1~10 사이의 랜덤 값 추출
SELECT TOP 1 * FROM @temp_table ORDER BY NEWID();

위의 쿼리를 실행하면 'num' 컬럼의 값이 1에서 10 사이의 값이 랜덤하게 나오는 것을 확인할 수 있다.

우리는 NEWID() 함수를 통해 데이터베이스 내의 임의의 값을 쿼리로 추출할 수 있다.

혹시나 테이블 변수, NEWID() 함수에 대해 자세히 알고 싶으면 아래의 포스팅을 참고하자.

가상 시나리오 작성

로또 번호를 랜덤으로 생성하는 쿼리를 짜본다고 가정해보자.

프로그램으로 짜면 쉬운데 굳이 왜 이런 로직을 데이터베이스에서 쿼리를 작성해야하는지 의문이 들 수도 있다.

하지만 여러 환경에 의해 SQL 쿼리로 로직을 짜야할 때도 있다.

실제로 내가 다니고 있는 회사에서는 거의 모든 처리 로직을 데이터베이스 내 프로시저로 처리하고 있다.

본론으로 돌아와서 내용을 정리해보면,

로또 번호를 랜덤으로 생성할 때 첫 번째 랜덤으로 뽑힌 숫자는 다음에 뽑을 숫자에서 제외되어야 한다.

즉, 첫 번째 랜덤한 값과 두 번째 랜덤한 값은 중복이 되면 안된다.

요구 사항은 다음과 같다.

데이터베이스 숫자 테이블 내의 데이터에서 여러 개의 값 중 랜덤으로 특정 값을 추출해야한다.
첫 번째로 뽑은 랜덤 값을 토대로, 두 번째로 뽑은 값은 첫 번째 값과 중복이 되지 않아야 한다.

내가 쿼리로 작성했던 내용은 다음과 같다.

WITH 구문을 사용
- 첫 번째 테이블에 랜덤의 첫 번째 값을 구함
- 두 번째 테이블에 첫 번째로 구한 값을 WHERE 조건절에 NOT IN을 이용하여 해당 중복값을 제거하고 새로 랜덤의 두 번째 값을 구함
두 랜덤한 결과값을 UNION 을 통해 데이터 통합

정말 중복 없이 서로 다른 숫자가 조회될까?

극단적으로 1과 2의 숫자만 있다고 하고, 위의 내용대로 쿼리를 작성해보자.

[ 주의! 꼭 확인해야 할 것 ]

예제 쿼리에서 사용되는 테이블 변수는 실행 시에만 존재하는 변수로, 하나의 단위로 실행시켜야 한다.

즉, 아래의 쿼리를 모두 한꺼번에 실행해야 된다.

-- 테이블 변수 생성
DECLARE @temp_table TABLE(
	num int
)

-- 테이블 변수에 1~2의 값 추가
DECLARE @i int = 1
WHILE @i <=2 BEGIN
	INSERT INTO @temp_table
		select @i

	SET @i += 1
END

;WITH
	-- 첫 번째 랜덤 값 추출
	cte_first AS (
		SELECT TOP 1 * FROM @temp_table ORDER BY NEWID()
	),
	-- 두 번째 랜덤 값 추출
	cte_second AS (
		SELECT TOP 1 * FROM @temp_table
		WHERE
			num not in (
				SELECT num FROM cte_first
			)
		ORDER BY NEWID()
	)
-- 랜덤 데이터 조회
SELECT * FROM cte_first
UNION
SELECT * FROM cte_second

두 번째 랜덤값은 첫 번째 값을 제외하고 랜덤으로 추출하였으니,

분명히 결과 값은 무조건 1과 2가 모두 나와야 한다.

과연 그럴까?

<랜덤 쿼리 실행 결과>

아니다.

여러 번을 조회해보면 실제로는 무조건적으로 1과 2의 값이 모두 나오지 않는다.

쿼리를 실행하면 다음과 같은 결과 중 하나의 결과를 마주하게 된다.

1과 2 모두 출력
1만 출력
2만 출력

왜 그럴까?

NEWID() 함수의 랜덤 액세스의 원리

NEWID() 함수는 쿼리가 실행 될 때마다 매번 다른 결과값을 호출한다.

그러니까 위의 쿼리에서는 첫 번째 값을 중복 안되게 제거하고 나머지의 값을 랜덤으로 다시 값을 액세스 하는 것이 아닌,

독립적으로 랜덤으로 액세스 된 값에서 첫 번째 값과 중복되는지 확인하게 될 뿐인 것이라는거다.

이해하기 쉽게 더 쉬운 쿼리로 작성해보자.

WITH 구문을 사용하여 무조건 하나의 랜덤 값만을 뽑도록 해보자.

그리고 해당 테이블을 중복이 있도록 UNION ALL로 합쳐 두 번 조회해보자.

사실 아래의 쿼리는 상사님께서 이해를 시켜주기 위해 쿼리를 쉽게 작성해주신 예제이다 :)

-- 테이블 변수 생성
DECLARE @temp_table TABLE(
	num int
)

-- 테이블 변수에 1~2의 값 추가
DECLARE @i int = 1
WHILE @i <=2 BEGIN
	INSERT INTO @temp_table
		select @i

	SET @i += 1
END

;WITH test AS (
	SELECT TOP 1 num FROM @temp_table ORDER BY NEWID()
)
SELECT * FROM test
UNION ALL
SELECT * FROM test

결과는 다음과 같다.

각각 1, 2
각각 2, 1
각각 1, 1
각각 2, 2

<랜던 쿼리 실행 결과>

그렇다면 랜덤 값 중복 제거는 어떻게 해야할까?

랜덤 값을 중복 없이 추출하여 조회하려면 어떻게 해야할까?

정답은 하나의 쿼리 내에서 NEWID() 함수를 각각 독립적으로 실행되지 않게 하면 된다.

이제 극단적인 1과 2만 있는 숫자 테이블에서,

각각의 값이 서로 중복되지 않도록 랜덤으로 출력하는 쿼리를 다시 작성해보자.

-- 테이블 변수 생성
DECLARE @temp_table TABLE(
	num int
)

-- 테이블 변수에 1~2의 값 추가
DECLARE @i int = 1
WHILE @i <=2 BEGIN
	INSERT INTO @temp_table
		select @i

	SET @i += 1
END

-- 랜덤값을 저장할 테이블 변수 생성
DECLARE @rand_table TABLE(
	rand_num int
)

-- 첫 번째 랜덤 값 테이블 변수에 저장
INSERT INTO @rand_table
	SELECT TOP 1 * FROM @temp_table ORDER BY NEWID()

-- 두 번째 랜덤 값 테이블 변수에 저장 : 테이블 변수에서 첫 번째 값을 확인하여 제외
INSERT INTO @rand_table
	SELECT TOP 1 * FROM @temp_table
	WHERE
		num NOT IN (
			SELECT rand_num FROM @rand_table
		)
	ORDER BY NEWID()

-- 랜덤 데이터 조회
SELECT * FROM @rand_table

첫 번째 NEWID() 함수로 추출된 램덤의 값을 테이블에 저장하고

다음 두 번째 랜덤 값 호출에서 데이터 중복 검사를 할 때,

NEWID() 함수를 독립적으로 실행되게 하지 않고 저장된 테이블에서 랜덤 값을 확인하여 중복을 제거하는 방식이다.

결과 값은 이제 중복이 되지 않고 1과 2 혹은 2와 1만 출력된다.

<랜덤 쿼리 실행 결과>

이 글을 작성한 이유는,

프로시저 내에서 짠 쿼리문의 결과가 자꾸 중복이 제거되지 않고 중복된 데이터가 함께 조회되는 문제로

며칠을 골머리 섞다가 시니어분께 요청하여 해결하게 된 결과를 공유하려는 마음에 작성하였다.

내가 너무 하나의 긴 쿼리문으로 모든 것을 해결하려 하진 않았는지 반성하게 된다.

1분 만에 해결하는 티스토리 블로그 사이트맵, RSS 제출하기 (+RSS 설정)

luvris2 — Thu, 11 Apr 2024 13:22:17 +0900

조금 다른 주제로 새롭게 시작하려는 블로그의 구글 서치 콘솔, 네이버 서치 어드바이저에 등록하기 위해

RSS, 사이트맵을 제출하는 과정에서 최대한 간단히, 바로 적용할 수 있게 정리해 보았다.

요점만 간단히 읽고 빠르게 사이트맵, RSS 제출해보자.

사이트맵 제출하기

사이트맵은 티스토리 블로그에서 자동 생성된다.

(이전에는 직접 사이트맵을 등록했었지만 이제는 티스토리에서 알아서 해준다.)

그러므로 따로 생성할 필요가 없으며,

자신의 블로그 주소 뒤에 https://블로그 주소/sitemap.xml 를 입력하면 내 티스토리 블로그의 사이트맵을 확인할 수 있다.

사이트맵을 요구하는 곳에 예시와 같이 뒤에 /sitemap.xml만 붙여서 기입하면 된다.

예시) https://luvris2.tistory.com/sitemap.xml

RSS 제출하기

RSS 또한 사이트맵과 동일하다.

자신의 블로그 주소 뒤에 https://블로그 주소/rss 경로를 입력하면 된다.

RSS를 요구하는 곳에 예시와 같이 뒤에 /rss만 붙여서 기입하면 된다.

예시) https://luvris2.tistory.com/rss

+ 사이트맵 주소 확인하기, RSS 설정하기

사이트맵 주소와 RSS 설정을 확인하려면,

자신의 티스토리 블로그 관리 페이지에서 '관리 - 블로그' 메뉴에 접근하면 된다.

사이트맵 주소 확인하기

'티스토리 관리 페이지 - 관리 - 블로그 - 주소 설정'에서 확인할 수 있다.

RSS 설정하기

RSS도 사이트맵 주소와 같은 경로에서 확인할 수 있다.

'티스토리 관리 페이지 - 관리 - 블로그 - 기타 설정'에서 확인 가능하다.

RSS는 전체 공개로 설정하며, 공개될 RSS를 50개로 갱신하도록 설정해 주는 것이 좋다.

RSS 설정을 변경하면 반드시 변경사항 저장 버튼을 눌러주자.

참고

티스토리 블로그 공지 - [안내] 블로그 사이트맵이 자동으로 생성됩니다.

고은별의 기술 공유 연구소

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.3.1

다운로드 링크

❓ 바이러스라고 다운로드가 안 돼요! / 바이러스라면서 다운로드하면 파일이 삭제돼요!

오류 수정사항

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.3.0

다운로드 링크

❓ 바이러스라고 다운로드가 안돼요! / 바이러스라면서 다운로드하면 파일이 삭제돼요!

추가 및 수정사항

미리보기

주간 컨텐츠 아이콘 추가

생활 컨텐츠 아이콘 추가

환경 설정 옵션 추가

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.2.1

다운로드 링크

추가 및 수정 사항 요약

유저 편의성 개선

체크할 숙제 콘텐츠를 추가하는 방식 변경

콘텐츠 아이콘 추가 및 변경

레이드 아이콘

콘텐츠 아이콘 변경

추가

변경

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.2.0

다운로드 링크

추가 및 수정 사항

업데이트 알림 기능 추가

숙제 및 생활 관련 편의성 개선

결계 알리미 관련

콘텐츠 아이콘 관련

추가

변경

수정

오류 수정

숙제 초기화 관련

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.1.1_fix

관련글

✅ 다운로드 링크

추가 및 수정 사항 (2025-06-18)

앞으로 업데이트 예정 리스트

발견된 이슈

프로그램 소개

✨ 모비노기 숙제 도우미란?

사용 가능한 환경

주요 기능

✅ 일일/주간 콘텐츠 체크 기능

나만의 캐릭터로, 더 몰입감 있게!

어떻게 활용되나요?

️ 사용 방법도 간단해요!

✏️ 내가 원하는 숙제, 직접 추가하세요! – 커스텀 콘텐츠 등록 기능

이런 상황, 다들 한 번쯤 있지 않으셨나요?

추가된 콘텐츠 미리 보기

생활 콘텐츠도 이제 꼼꼼하게! – 세분화된 생활 숙제 관리 기능 추가

어떤 점이 좋아졌나요?

⚙️ 더 나에게 맞게! – 환경 설정 옵션으로 보기 방식을 자유롭게 조절하세요

⚙️ 환경 설정 > 구매 및 교환

추가된 콘텐츠 아이콘 미리 보기

❓ 숙제 체크를 잘못했을 때에는? 실수해도 괜찮아요!

❓숙제 콘텐츠가 계속 하나만 추가되요!

내 숙제, 내 방식대로 정리한다 – 메모장 기능 추가!

✨ 어떤 걸 쓸 수 있나요?

주요 기능

결계 알림 기능

⚙️ 환경 설정 > 결계 알리미

⏰ 10분 전 / 5분 전 미리 알림

⏰ 정각 알림 – 결계가 생성되면 즉시 알림!

⏳ 결계 시작 3분 전 타이머 알림 – 결계 시작 전 집중 준비 시간 확보!

️ 결계 알림 팝업은 윈도우 좌측 하단에서 확인! – '아.. 맞다.. 결계!' 게임 중에도 알림을 놓치지 말자!

️ 깔끔하게 종료하거나, 조용히 숨겨두거나 – 트레이 기능 추가

⚙️ 환경 설정 > 닫기 설정

문제가 생겼을 땐, 처음으로!

⚠️ 초기화 시 주의사항!

참고

사용 스킬

프로그램 개발 히스토리

마비노기 모바일 숙제 도우미 - 모비노기 도우미 v1.0

수정사항

프로그램 소개

✨ 모비노기 숙제 도우미란?

✅ 다운로드 링크