> For the complete documentation index, see [llms.txt](https://data-programs.gitbook.io/singularity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://data-programs.gitbook.io/singularity/kr/faq/database-is-locked.md).

# 데이터베이스가 잠김

Singularity의 기본 데이터베이스 백엔드 (SQLite3)를 사용할 때 "데이터베이스가 잠겼습니다" 오류 메시지가 발생할 수 있습니다.

## 왜 이런 일이 발생하나요?

SQLite3는 파일을 데이터베이스로 사용하여 작동합니다. 기록 작업이 수행될 때마다 SQLite3는 이 파일을 잠그게 됩니다. 동시에 여러 기록 작업을 시도하는 경우 "데이터베이스가 잠겼습니다" 오류가 발생합니다.

## 어떻게 해야 하나요?

* **자동 재시도** : Singularity는 이 오류가 발생하는 작업을 자동으로 재시도하도록 설계되었습니다. 따라서 대부분의 경우 이 오류 메시지를 무시해도 됩니다.
* **소프트웨어 정지** : 이 오류로 인해 Singularity가 응답하지 않는 것으로 생각되면 버그로 보고해주십시오.

## 제품 환경에서의 권장사항

SQLite는 개발 또는 경량 작업에 적합하지만, 제품 환경에서는 권장되지 않습니다. 더 견고한 데이터베이스 백엔드를 사용하여 Singularity를 제품 환경에 배포하는 방법에 대한 안내는 [제품 환경에 배포하기 가이드](/singularity/kr/installation/deploy-to-production.md)를 참조하십시오.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://data-programs.gitbook.io/singularity/kr/faq/database-is-locked.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.