🤷‍♀️ 🤷‍♂️ Golang에서 jackc/pgx 드라이버 사용 시 PostgreSQL 오류: X를 Y로 변환할 수 없음

소개

이봐, DEV 사람들! 👋 오늘 저는 "단순 오류"라는 새로운 짧은 기사 시리즈를 시작합니다. 여기에서 지금까지 프로그래밍 실습에서 만난 다양한 막다른 골목과 함정을 다룰 것입니다.

저는 이러한 기사를 작성할 때 항상 다음 네 가지 규칙을 따르려고 노력할 것입니다.

오류 원인에 대한 설명

나에게 오류가 발생한 입력 데이터에 대한 설명;

오류에 대한 나의 해결책;

결론 및 동기 부여 단어;

너무 가혹하게 판단하지 말고, 그런 기사에 대해 어떻게 생각하는지 쓰고, 댓글에서 구문 분석을 위한 자신만의 주제를 제안하세요... 시작합니다! 🚀

📝 목차

Explanation of the error

Input data when an error occurs

Resolving the error

Conclusions

오류 설명

고성능 드라이버jackc/pgx를 통해 PostgreSQL 데이터베이스를 사용하여 Golang에서 REST API(또는 기타 제품)를 개발할 때 때때로 정보 검색에 혼란을 줄 수 있는 간단한 오류가 발생할 수 있습니다. 특히, 신규 이민자.

이 간단한 오류는 다음과 같습니다. cannot convert [SOMETHING] to [SOMETHING] . 제 경우에는 cannot convert 1 to Text 처럼 보였습니다.

이 오류 메시지는 jackc/pgx 패키지에서 발생하며 내부적으로 준비된 명령문을 사용하는 이 패키지와 자리 표시자의 유형을 결정할 수 없는 PostgreSQL의 조합으로 인해 발생합니다.

👍 Thanks for this explanation to author of this comment.

↑ Table of contents

오류 발생 시 입력 데이터

먼저 내 애플리케이션의 데이터베이스에 프로젝트 테이블을 생성하는 마이그레이션 파일을 살펴보겠습니다.

-- ./platform/migration/000001_create_init_tables.up.sql

-- Create projects table
CREATE TABLE "projects" (
  "id" UUID PRIMARY KEY DEFAULT (uuid_generate_v4()),
  "created_at" timestamp DEFAULT (now()),
  "updated_at" timestamp,
  "user_id" UUID NOT NULL,
  "alias" varchar(255) UNIQUE NOT NULL,
  "project_status" int NOT NULL,
  "project_attrs" JSONB NOT NULL
);

// ...

필드에는 매우 구체적인 유형이 있으며 이 테이블에서 데이터를 생성/수정할 때 Postgres에서 유효성을 검사합니다.

이제 이 마이그레이션에 적합한 Go 모델을 살펴보겠습니다.

// ./app/controllers/project_model.go

// Project struct to describe project object.
type Project struct {
    ID            uuid.UUID    `db:"id" json:"id"`
    CreatedAt     time.Time    `db:"created_at" json:"created_at"`
    UpdatedAt     time.Time    `db:"updated_at" json:"updated_at"`
    UserID        uuid.UUID    `db:"user_id" json:"user_id"`
    Alias         string       `db:"alias" json:"alias"`
    ProjectStatus int          `db:"project_status" json:"project_status"`
    ProjectAttrs  ProjectAttrs `db:"project_attrs" json:"project_attrs"`
}

// ProjectAttrs struct to describe project attributes.
type ProjectAttrs struct {
    Title       string `json:"title"`
    Description string `json:"description"`
    Picture     string `json:"picture"`
    URL         string `json:"url"`
}

// ...

예, Go 모델의 JSOB 필드 유형이 정규 구조가 되어 project_attrs 데이터베이스 필드에 JSON 형식으로 저장된다는 것이 맞습니다.

👌 Other fields are quite normal for any Go project.

↑ Table of contents

오류 해결

이 간단한 오류에 대한 해결책으로 원활하게 이동합시다.

솔루션에 대해 알아야 할 것은 PostgreSQL에서 쿼리에서 직접 자리 표시자에 대한 유형을 지정할 수 있다는 것입니다. 마이그레이션 파일에서 지정한 유형을 쿼리에 추가하기만 하면 됩니다.

필드 유형을 지정하는 형식은 다음과 같습니다: $N::<TYPE> (달러 기호 + 자리 표시자 번호 + 두 개의 콜론 + DB의 필드 유형).

// ./app/controllers/project_query.go

// CreateProject method for creating project by given Project object.
func (q *ProjectQueries) CreateProject(p *models.Project) error {
    // Define query string.
    // We define type for each field to solve this simple error.
    query := `
    INSERT INTO projects 
    VALUES ($1::uuid, $2::timestamp, $3::timestamp, $4::uuid, $5::varchar, $6::int, $7::jsonb)
    `

    // Send query to database.
    _, err := q.Exec(query, p.ID, p.CreatedAt, p.UpdatedAt, p.UserID, p.Alias, p.ProjectStatus, p.ProjectAttrs)
    if err != nil {
        // Return only error.
        return err
    }

    // This query returns nothing.
    return nil
}

// ...

☝️ Once again, please note that we are specifying the PostgreSQL field type from the migration, not the Go structure from the model!

프로젝트를 빌드하고 이 끝점을 요청하면 오류가 더 이상 표시되지 않고 요청이 성공합니다! 🎉

↑ Table of contents

결론

개인적으로 저는 jackc/pgx 패키지 구성에서 이 검사를 완전히 비활성화하는 것보다 이런 종류의 항목을 더 좋아합니다(추가 정보here ).

컨트롤러에서 구현의 세부 사항에 뛰어들 필요 없이 SQL 쿼리를 한눈에 볼 수 있기 때문에 필드 유형을 즉시 이해할 수 있습니다.

자신에게 편리한 옵션을 선택하고 사용하십시오. 방금 개인적으로 도움이 된 솔루션의 방법을 보여 드렸습니다. 성공적인 작업을 수행하고 간단한 오류로 인해 프로젝트를 실현하는 데 방해가 되지 않도록 하십시오! 😉

↑ Table of contents

사진 및 동영상

아룬 프라카쉬 https://unsplash.com/photos/pE9mgLMwee0

켄달 루스 https://unsplash.com/photos/AijuW-HlE30

추신

이 블로그에서 이와 같은 기사를 더 원하시면 아래에 댓글을 게시하고 저를 구독하십시오. 감사! 😘

그리고 물론 LiberaPay 에 기부하시면 저를 후원하실 수 있습니다. 각 기부금은 새로운 기사를 작성하고 커뮤니티를 위한 비영리 오픈 소스 프로젝트를 개발하는 데 사용됩니다.