منصوبے کے بارے میں

lib/pq PostgreSQL ڈرائیور کا ایک خالص Go نفاذ ہے جو Go کے معیاری database/sql پیکیج کے ساتھ مربوط ہوتا ہے۔ یہ PostgreSQL کے تمام موجودہ تعاون یافتہ ورژنز کو سپورٹ کرتا ہے اور libpq کے ساتھ مطابقت رکھنے والا ایک معروف DSN فارمیٹ فراہم کرتا ہے، جو key=value اور postgres:// URL طرز کے کنکشن سٹرنگز دونوں کو قبول کرتا ہے۔ اہم خصوصیات میں شامل ہیں: - **تصدیق**: PASSWORD، MD5، اور SCRAM-SHA256 کو بغیر کسی اضافی ترتیب کے سپورٹ کرتا ہے۔ اختیاری GSS/Kerberos تصدیق ایک علیحدہ auth/kerberos ماڈیول کے ذریعے دستیاب ہے تاکہ غیر ضروری انحصار سے بچا جا سکے۔ pgpass فائل سپورٹ بھی شامل ہے۔ - **بلک امپورٹ**: COPY [..] FROM STDIN کو ٹرانزیکشنز کے اندر موثر بلک ڈیٹا لوڈنگ کے لیے سپورٹ کیا جاتا ہے۔ - **LISTEN/NOTIFY**: ایک pq.Listener قسم PostgreSQL نوٹیفیکیشنز کو Go چینل پر پہنچاتی ہے، جس سے ریئل ٹائم ایونٹ پر مبنی پیٹرن ممکن ہوتے ہیں۔ - **خرابی سے نمٹنا**: PostgreSQL خرابیاں pq.Error کے طور پر منظم فیلڈز کے ساتھ واپس کی جاتی ہیں۔ pq.As ہیلپر خرابیوں کو pq.Error اقسام میں تبدیل کرتا ہے، اور ErrorWithDetail() ڈیبگنگ کے لیے DETAIL اور CONTEXT معلومات شامل کرتا ہے۔ - **NOTICE ہینڈلنگ**: PostgreSQL سے معلوماتی NOTICE پیغامات کو ایک قابل ترتیب کال بیک ہینڈلر کے ذریعے حاصل کیا جا سکتا ہے۔ - **رن ٹائم پیرامیٹرز**: libpq کے برعکس، pq کنکشن سٹرنگ میں براہ راست search_path یا work_mem جیسے رن ٹائم پیرامیٹرز سیٹ کرنے کی اجازت دیتا ہے۔ - **Config سٹرکچر**: ایک pq.Config سٹرکچر پروگرامیٹک کنکشن کنفیگریشن فراہم کرتا ہے، جس میں pq.NewConfig DSN سٹرنگز کو پارس کرتا ہے اور pq.NewConnectorConfig ایک کنیکٹر بناتا ہے۔ README میں دستاویز کردہ احتیاطی نوٹس میں شامل ہیں: LastInsertId سپورٹ نہیں ہے (اس کے بجائے INSERT ... RETURNING استعمال کریں)، ٹائم اسٹیمپ ہینڈلنگ timestamptz کے لیے سرور ٹائم زون اور بغیر ٹائم زون کے timestamp کے لیے ایک فکسڈ زیرو آفسیٹ زون استعمال کرتی ہے، اور COPY کے دوران bytea انکوڈنگ jsonb کالموں کے ساتھ مسائل پیدا کر سکتی ہے۔ اس پروجیکٹ میں ایک جامع ٹیسٹ سوٹ شامل ہے جو Docker Compose کے ذریعے متعدد PostgreSQL ورژنز، pgbouncer، اور pgpool کے خلاف چلایا جا سکتا ہے۔ PQGO_DEBUG=1 ماحولیاتی متغیر ٹربل شوٹنگ کے لیے پروٹوکول سطح کی ڈیبگ آؤٹ پٹ کو فعال کرتا ہے۔