DB_CLUSTER_NAME: 데이터베이스 클러스터의 이름입니다(예: my-db-cluster).
DB_CLUSTER_NAMESPACE: 데이터베이스 클러스터의 네임스페이스 이름입니다.
다음 오류 코드가 있을 수 있는 데이터베이스 클러스터 상태 조건과 criticalincidents 필드를 확인합니다.
AlloyDB Omni 오류 코드
오류 코드
설명
권장 조치
DBSE0601.PgBackRest: Failed to backup
AlloyDB Omni는 백업 및 복원 관련 기능에 pgBackRest를 사용합니다. 이 오류는 pgBackRest가 요청된 백업을 수행하지 못한 경우 백업 리소스에서 발생할 수 있습니다.
이 문제가 발생하면 다음 로그에서 자세한 내용을 확인하세요. /obs/pgbackrest/db-backup.log directory의 데이터베이스 포드의 obs 디스크에 있는 pgBackRest 백업 로그 /obs/diagnostic/postgresql.log directory의 데이터베이스 포드의 obs 디스크에 있는 PostgreSQL 데이터베이스 로그
DBSE0604.pgBackRest: Failed to restore
AlloyDB Omni는 백업 및 복원 관련 기능에 pgBackRest를 사용합니다. 이 오류는 pgBackRest가 복원하지 못한 경우 복원 리소스에서 발생할 수 있습니다.
이 문제가 발생하면 다음 로그에서 자세한 내용을 확인하세요. * /obs/pgbackrest/db-restore.log 디렉터리의 데이터베이스 포드에 있는 obs 디스크의 pgBackRest 복원 로그
* PostgreSQL 데이터베이스 로그는 /obs/diagnostic/postgresql.log 디렉터리의 데이터베이스 포드 obs 디스크에 있습니다.
DBSE1080. HA: Failed to stop primary database
이 오류는 기본 데이터베이스가 제대로 중지되지 않을 때 발생합니다. 데이터베이스가 응답하지 않거나 데이터베이스가 중지될 때까지 기다리는 시간이 초과되었기 때문일 수 있습니다.
장애 조치 중에 이 문제가 발생하면 장애 조치 작업에서 새 기본 데이터베이스를 계속 승격하려고 시도합니다. 문제가 계속되면 데이터베이스를 수동으로 복구하거나 다시 만들어야 할 수 있습니다.
DBSE1081. Failed to promote standby database
이 오류는 대기 데이터베이스를 승격하려고 할 때 장애 조치 또는 전환 중에 발생할 수 있습니다. 자세한 내용은 오류 메시지를 확인하세요.
이 경우 장애 조치 또는 전환 작업은 이전 기본 데이터베이스로 롤백하려고 시도합니다. 롤백이 실패하면 이 데이터베이스 클러스터를 수동으로 복구하거나 다시 시작하거나 다시 만들어야 할 수 있습니다.
DBSE1082. Failed to rewind the database
이 오류는 기본 데이터베이스를 대기 데이터베이스로 변경하려고 하는 작업 중에 발생할 수 있습니다. 자세한 내용은 오류 메시지를 확인하세요.
장애 조치 또는 전환 작업 중에 이 문제가 발생하면 AlloyDB Omni는 이전 기본 데이터베이스로 롤백하려고 시도합니다. 롤백이 실패하면 데이터베이스 클러스터를 수동으로 복구하거나 다시 시작하거나 다시 만들어야 할 수 있습니다.
DBSE2411. PostgreSQL: Failed to create physical replication slot
이 오류는 다운스트림 복제를 설정하려고 할 때 업스트림 인스턴스에서 발생할 수 있습니다. 오류 메시지에서 추가 세부정보를 확인하세요.
오류가 계속되면 복제 설정 프로세스를 다시 시작해야 할 수 있습니다.
DBSE2412. PostgreSQL: Failed to query replication slots
이 오류는 업스트림 인스턴스에서 발생할 수 있습니다.
오류가 발생한 원인에 대한 자세한 내용은 오류 메시지를 확인하세요.
DBSE2413. PostgreSQL: Failed to reload config
이 오류는 데이터베이스 매개변수가 변경되었으며 다시 로드할 수 없는 경우에 발생할 수 있습니다.
자세한 내용은 오류 메시지를 확인하세요. 메시지에 특정 매개변수로 인해 오류가 발생한다고 표시되면 매개변수를 변경해야 할 수 있습니다.
DBSE2414. PostgreSQL: Failed to run pg_basebackup
이 오류는 새 다운스트림 인스턴스의 복제 설정 중에 발생합니다.
자세한 내용은 오류 메시지를 확인하세요. 오류가 계속되면 이 인스턴스를 수동으로 삭제하고 복제 프로세스를 다시 시작해야 할 수 있습니다.
DBSE2415. PostgreSQL: failed to connect to database
이 오류는 운영자 에이전트가 데이터베이스에 연결할 수 없는 경우에 발생합니다.
데이터베이스가 종료되었거나 비정상 종료되었을 가능성이 가장 높습니다. 자세한 내용은 오류 메시지를 참고하세요.
DBSE2416. PostgreSQL: Failed to set synchronous standby names
이 오류는 복제를 설정할 때 업스트림 인스턴스에서 발생할 수 있습니다. 동기식 대기 이름이 올바르게 설정되지 않은 경우 대기 이름은 비동기식입니다.
자세한 내용은 오류 메시지를 확인하세요. 문제가 지속되면 복제를 사용 중지했다가 다시 사용 설정해야 할 수 있습니다.
DBSE2417. PostgreSQL: Failed to terminate replication
이 오류는 다운스트림 인스턴스가 변경된 경우(예: 대기 인스턴스 수가 감소한 경우) 업스트림 인스턴스에서 발생할 수 있습니다.
자세한 내용은 오류 메시지를 확인하세요. 문제가 지속되면 복제를 사용 중지했다가 다시 사용 설정해야 할 수 있습니다.
DBSE2418. PostgreSQL: Failed to drop replication slot
이 오류는 다운스트림 인스턴스가 변경된 경우(예: 대기 인스턴스 수가 감소한 경우) 업스트림 인스턴스에서 발생할 수 있습니다.
자세한 내용은 오류 메시지를 확인하세요. 문제가 지속되면 복제를 사용 중지했다가 다시 사용 설정해야 할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-02(UTC)"],[[["\u003cp\u003eThis page outlines error codes encountered in AlloyDB Omni, along with their descriptions and recommended fixes.\u003c/p\u003e\n"],["\u003cp\u003eError codes are extracted by checking the database cluster status conditions and \u003ccode\u003ecriticalincidents\u003c/code\u003e fields in the database cluster manifest obtained via \u003ccode\u003ekubectl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eErrors such as \u003ccode\u003eDBSE0601\u003c/code\u003e and \u003ccode\u003eDBSE0604\u003c/code\u003e relate to pgBackRest failures during backup or restore processes, requiring checks of pgBackRest and PostgreSQL logs.\u003c/p\u003e\n"],["\u003cp\u003eErrors like \u003ccode\u003eDBSE1080\u003c/code\u003e, \u003ccode\u003eDBSE1081\u003c/code\u003e, and \u003ccode\u003eDBSE1082\u003c/code\u003e indicate issues with primary database stopping, standby promotion, or database rewinding during failover or switchover, which might require manual database repair or recreation.\u003c/p\u003e\n"],["\u003cp\u003eErrors like \u003ccode\u003eDBSE2411\u003c/code\u003e to \u003ccode\u003eDBSE2418\u003c/code\u003e point to replication-related problems, such as failing to set up replication, issues with synchronous standby names, or failed replication terminations, all of which require consulting the error message and potentially restarting the replication process.\u003c/p\u003e\n"]]],[],null,["# Diagnose error codes\n\nSelect a documentation version: 15.7.0keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/error-codes)\n- [16.8.0](/alloydb/omni/16.8.0/docs/error-codes)\n- [16.3.0](/alloydb/omni/16.3.0/docs/error-codes)\n- [15.12.0](/alloydb/omni/15.12.0/docs/error-codes)\n- [15.7.1](/alloydb/omni/15.7.1/docs/error-codes)\n- [15.7.0](/alloydb/omni/15.7.0/docs/error-codes)\n\n\u003cbr /\u003e\n\nThis page describes AlloyDB Omni error codes and recommended fixes.\n\n\u003cbr /\u003e\n\nExtract an error\n----------------\n\nTo extract an error code, follow these steps:\n\n1. To get your database cluster manifest, run:\n\n kubectl get dbclusters.a \u003cvar translate=\"no\"\u003eDB_CLUSTER_NAME\u003c/var\u003e -n \u003cvar translate=\"no\"\u003eDB_CLUSTER_NAMESPACE\u003c/var\u003e -o yaml\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eDB_CLUSTER_NAME\u003c/var\u003e: the name of your database cluster---for example, `my-db-cluster`.\n - \u003cvar translate=\"no\"\u003eDB_CLUSTER_NAMESPACE\u003c/var\u003e: the name of the namespace of your database cluster.\n2. Check for database cluster status conditions and `criticalincidents` fields that might have some of the following error codes.\n\nAlloyDB Omni error codes\n------------------------"]]
