TypeScript Upsert PostgreSQL সিকোয়েন্স ত্রুটি: "সম্পর্ক 'customers_sq' বিদ্যমান নেই"

আপসার্টে PostgreSQL সিকোয়েন্স ত্রুটি বোঝা

PostgreSQL এবং TypeScript-এর সাথে কাজ করা, বিশেষ করে একটি আপসার্ট অপারেশনের সময়, কখনও কখনও অপ্রত্যাশিত ক্রম ত্রুটির কারণ হতে পারে। এরকম একটি সাধারণ ত্রুটির সাথে ডাটাবেস একটি ক্রমকে স্বীকৃতি দেয় না, যার ফলে "সম্পর্ক 'গ্রাহক_sq' বিদ্যমান নেই" এর মতো বার্তা আসে। এসকিউএল কোয়েরির মধ্যে ভুলভাবে অনুক্রম উল্লেখ করার সময় এই ত্রুটিটি সাধারণত ঘটে।

এই নিবন্ধে, আমরা একটি বাস্তব-বিশ্বের দৃশ্যকল্প অন্বেষণ করব যেখানে একজন বিকাশকারী একটি আপসার্ট সম্পাদন করার সময় এই সমস্যার সম্মুখীন হন। আমরা পোস্টগ্রেএসকিউএল-এ সিকোয়েন্সগুলি কীভাবে কাজ করে তা নিয়ে আলোচনা করব এবং তাদের উল্লেখ করার সময় সাধারণ ভুলগুলি চিহ্নিত করব, বিশেষ করে টাইপস্ক্রিপ্টে।

প্রায়শই, ভুল সিনট্যাক্স বা স্কিমা স্কোপিংয়ের কারণে এই ত্রুটিগুলি দেখা দেয়, বিশেষ করে যখন বিভিন্ন ডাটাবেস স্কিমা বা নেমস্পেসে সিকোয়েন্স নিয়ে কাজ করা হয়। ইস্যুটি ডিবাগ করার জন্য পোস্টগ্রেএসকিউএল কীভাবে প্রশ্নগুলিতে রেফারেন্স করা হবে বলে আশা করে সেদিকে সতর্ক মনোযোগ দেওয়া দরকার।

এই নির্দেশিকাটির শেষের মধ্যে, কেন এই "সম্পর্ক বিদ্যমান নেই" ত্রুটিটি ঘটছে এবং এটি ঠিক করার জন্য আপনি কী পদক্ষেপ নিতে পারেন সে সম্পর্কে আপনি আরও পরিষ্কারভাবে বুঝতে পারবেন। এর মধ্যে রয়েছে সিকোয়েন্স রেফারেন্স সমস্যা সমাধানের জন্য ব্যবহারিক টিপস এবং পোস্টগ্রেএসকিউএল-এর উদ্দেশ্য অনুযায়ী আপনার আপসার্ট কাজ করা নিশ্চিত করা।

আপসার্টে পোস্টগ্রেএসকিউএল সিকোয়েন্স ত্রুটিগুলি কীভাবে পরিচালনা করবেন

পূর্ববর্তী উদাহরণগুলিতে প্রদত্ত স্ক্রিপ্টগুলি পোস্টগ্রেএসকিউএল-এ অনুক্রমগুলি উল্লেখ করার সময় উদ্ভূত একটি সাধারণ সমস্যা সমাধানের জন্য ডিজাইন করা হয়েছে, বিশেষত একটি upsert টাইপস্ক্রিপ্টে অপারেশন। একটি আপসার্ট অপারেশন হয় নতুন রেকর্ড সন্নিবেশ করায় বা বিদ্যমানগুলি আপডেট করে, অনন্য প্রাথমিক কীগুলি বজায় রাখার জন্য সিকোয়েন্সের সঠিক ব্যবহারকে গুরুত্বপূর্ণ করে তোলে। এখানে মূল সমস্যাটি ভুল ক্রম রেফারেন্স থেকে উদ্ভূত হয়, যা ত্রুটির দিকে পরিচালিত করে: "সম্পর্ক '' বিদ্যমান নেই। সমাধানের মধ্যে সঠিক PostgreSQL ফাংশন কল করা জড়িত, পরবর্তী, ক্রম থেকে পরবর্তী মান তৈরি করতে, "গ্রাহক" টেবিলের প্রতিটি নতুন রেকর্ডে একটি অনন্য আইডি বরাদ্দ করা হয়েছে তা নিশ্চিত করা।

প্রথম স্ক্রিপ্টটি স্কিমা সচেতনতার সাথে ক্রমটি সঠিকভাবে উল্লেখ করা হয়েছে তা নিশ্চিত করে এই সমস্যাটির সমাধান করে। আমরা যখন ব্যবহার করি NEXTVAL('db.customers_sq'), আমরা স্কিমা ("db") এবং সিকোয়েন্স ("customers_sq") উভয়ই নির্দিষ্ট করি, নিশ্চিত করি যে PostgreSQL সঠিক প্রেক্ষাপটে ক্রমটি খুঁজছে। যদি স্কিমাটি বাদ দেওয়া হয় বা ভুলভাবে উল্লেখ করা হয়, তাহলে PostgreSQL ক্রমটি খুঁজে নাও পেতে পারে, ত্রুটিটি ট্রিগার করে। এই কমান্ড একটি মধ্যে কাজ করে প্যারামিটারাইজড প্রশ্ন টাইপস্ক্রিপ্টে, SQL ইনজেকশন আক্রমণ প্রতিরোধ করতে ব্যবহারকারীর ইনপুট নিরাপদে ক্যোয়ারীতে পাস করা হয়েছে তা নিশ্চিত করে।

উপরন্তু, গতিশীল ক্রম চেকিং ব্যবহার করে একটি বিকল্প সমাধান প্রদান করা হয়। এই পদ্ধতিটি PostgreSQL ক্যাটালগ ভিউকে জিজ্ঞাসা করে, pg_sequences, রেকর্ড সন্নিবেশ বা আপডেট করার চেষ্টা করার আগে অনুক্রমের অস্তিত্ব যাচাই করতে। এটি শুধুমাত্র ত্রুটি পরিচালনার একটি স্তর যোগ করে না বরং এটি নিশ্চিত করে যে স্ক্রিপ্টটি নমনীয় এবং শক্তিশালী, ডাটাবেস স্কিমার পরিবর্তনের সাথে মানিয়ে নিতে সক্ষম। গতিশীলভাবে ক্রমটি পরীক্ষা করে, ডিবাগিং প্রক্রিয়ার উন্নতি করে, যদি অনুক্রমটি অনুপস্থিত থাকে বা ভুলভাবে উল্লেখ করা হয় তবে সিস্টেমটি আরও তথ্যপূর্ণ ত্রুটি বার্তা প্রদান করতে পারে।

অবশেষে, ইউনিট পরীক্ষা সমাধানের একটি অপরিহার্য অংশ। দ ঠাট্টা আপসার্ট ফাংশন প্রত্যাশিত হিসাবে আচরণ করে তা নিশ্চিত করতে পরীক্ষা স্যুট ব্যবহার করা হয়। পরীক্ষায়, সফল ক্রিয়াকলাপ এবং ত্রুটির ক্ষেত্রে, যেমন অনুপস্থিত ক্রম, উভয়ই পরিচালনা করা হয়। পরীক্ষার ক্ষেত্রে যেমন পদ্ধতি ব্যবহার করা হয় mockResolvedValueOnce এবং mockRejectedValueOnce ডাটাবেস প্রশ্নের উত্তর কিভাবে অনুকরণ করতে. সঠিক SQL কমান্ড কার্যকর করা হয়েছে এবং সিকোয়েন্স অনুপস্থিত থাকলে ত্রুটিগুলি যথাযথভাবে নিক্ষেপ করা হয়েছে তা যাচাই করে, পরীক্ষার ক্ষেত্রে বিভিন্ন পরিবেশে সমাধানের নির্ভরযোগ্যতা নিশ্চিত করতে সহায়তা করে।

// TypeScript - Upsert solution using parameterized query with correct sequence reference
import { Pool } from 'pg';
const pool = new Pool();
const SAVE_CUSTOMER = `
  INSERT INTO "db"."customers" ("id", "name")
  VALUES (NEXTVAL('db.customers_sq'), $1)
  ON CONFLICT ("id") DO UPDATE SET "name" = $1`;
async function saveCustomer(name: string) {
  try {
    await pool.query(SAVE_CUSTOMER, [name]);
    console.log('Customer saved successfully');
  } catch (error) {
    console.error('Error saving customer:', error.message);
  }
}

// TypeScript - Dynamic sequence referencing with schema awareness
import { Pool } from 'pg';
const pool = new Pool();
async function saveCustomer(name: string) {
  try {
    const checkSequence = `SELECT EXISTS (
      SELECT 1 FROM pg_sequences WHERE schemaname = 'db' AND sequencename = 'customers_sq');`;
    const sequenceExists = await pool.query(checkSequence);
    if (!sequenceExists.rows[0].exists) {
      throw new Error('Sequence not found');
    }
    const SAVE_CUSTOMER = `
      INSERT INTO "db"."customers" ("id", "name")
      VALUES (NEXTVAL('db.customers_sq'), $1)
      ON CONFLICT ("id") DO UPDATE SET "name" = $1`;
    await pool.query(SAVE_CUSTOMER, [name]);
    console.log('Customer saved successfully');
  } catch (error) {
    console.error('Error saving customer:', error.message);
  }
}

// Jest - Unit test for saveCustomer function
import { saveCustomer } from './saveCustomer';
import { pool } from 'pg';
jest.mock('pg');
describe('saveCustomer', () => {
  it('should insert new customer if no conflict', async () => {
    pool.query.mockResolvedValueOnce({});
    await saveCustomer('John Doe');
    expect(pool.query).toHaveBeenCalledWith(expect.any(String), ['John Doe']);
  });
  it('should throw error if sequence does not exist', async () => {
    pool.query.mockRejectedValueOnce(new Error('Sequence not found'));
    await expect(saveCustomer('John Doe')).rejects.toThrow('Sequence not found');
  });
});

PostgreSQL সিকোয়েন্স ত্রুটির পিছনে মূল কারণ

একটি দিক আগে কভার করা হয়নি তা হল PostgreSQL কিভাবে পরিচালনা করে ক্ষেত্রে সংবেদনশীলতা যখন এটি সিকোয়েন্সের মতো ডাটাবেস অবজেক্টের ক্ষেত্রে আসে। পোস্টগ্রেএসকিউএল অ-উদ্ধৃত শনাক্তকারীকে ছোট হাতের অক্ষর হিসাবে বিবেচনা করার জন্য ডিফল্ট। এর মানে হল যে যদি একটি সিকোয়েন্স নাম বড় হাতের অক্ষর দিয়ে তৈরি করা হয় কিন্তু উদ্ধৃতি ছাড়াই উল্লেখ করা হয়, PostgreSQL স্বয়ংক্রিয়ভাবে ছোট হাতের সংস্করণের জন্য অনুসন্ধান করবে। উদাহরণস্বরূপ, যদি ক্রমটি "গ্রাহক_এসকিউ" হিসাবে তৈরি করা হয়েছিল তবে হিসাবে উল্লেখ করা হয়েছে NEXTVAL('customers_sq'), এটি ত্রুটি হতে পারে, "সম্পর্ক বিদ্যমান নেই"। ক্রম নামের চারপাশে ডবল উদ্ধৃতি ব্যবহার করা, যেমন NEXTVAL('"Customers_SQ"'), নিশ্চিত করে যে PostgreSQL সংজ্ঞায়িত হিসাবে সঠিক কেস ব্যবহার করে।

আরেকটি গুরুত্বপূর্ণ দিক হল PostgreSQL-এ স্কিমা দৃশ্যমানতা। ডিফল্টরূপে, PostgreSQL স্কিমার ক্রমগুলির জন্য অনুসন্ধান করে যা অনুসন্ধানের পথে প্রথম হয় যদি না একটি স্কিমা স্পষ্টভাবে সংজ্ঞায়িত করা হয়। যদি ক্রমটি একটি ভিন্ন স্কিমাতে থাকে, স্কিমা উল্লেখ না করেই এটিকে উল্লেখ করা (যেমন, NEXTVAL('db.customers_sq')) একটি ক্রম-না পাওয়া ত্রুটির দিকে নিয়ে যেতে পারে। এই সমস্যা এড়াতে ডেভেলপারদের হয় অনুসন্ধানের পথ সামঞ্জস্য করতে হবে বা স্কিমাকে স্পষ্টভাবে উল্লেখ করতে হবে, বিশেষ করে একাধিক স্কিমা সহ জটিল ডাটাবেস কাঠামোতে।

সবশেষে, ডাটাবেস উল্লেখ করা গুরুত্বপূর্ণ অনুমতি. যদি একজন ব্যবহারকারীর একটি ক্রম অ্যাক্সেস বা সংশোধন করার জন্য প্রয়োজনীয় বিশেষাধিকার না থাকে, তাহলে তারা "সম্পর্ক বিদ্যমান নেই" এর মতো ত্রুটির সম্মুখীন হতে পারে। ডাটাবেস সিকোয়েন্সের সাথে ইন্টারঅ্যাক্ট করা ভূমিকাগুলির সঠিক অনুমতি প্রদান নিশ্চিত করে যে তারা এর মাধ্যমে পরবর্তী মান পুনরুদ্ধার করতে পারে NEXTVAL সমস্যা ছাড়াই। কঠোর অ্যাক্সেস নিয়ন্ত্রণ এবং ডাটাবেসের সাথে ইন্টারঅ্যাক্ট করার একাধিক ভূমিকা সহ উত্পাদন পরিবেশে এটি বিশেষভাবে গুরুত্বপূর্ণ।