Cloud SQL Connector for Java عبارة عن مكتبة توفر تفويضًا وتشفيرًا يستندان إلى IAM عند الاتصال بمثيل Cloud SQL. ولا يمكنه توفير مسار شبكة لمثيل Cloud SQL إذا لم يكن موجودًا بالفعل. راجع صفحة نظرة عامة على الاتصال لمزيد من المعلومات حول الاتصال بمثيل Cloud SQL.
للحصول على معلومات الاستخدام الخاصة بمحرك قاعدة البيانات وبرنامج التشغيل، راجع الصفحات أدناه:
الاتصال بـ Cloud SQL باستخدام JDBC
الاتصال بـ Cloud SQL باستخدام R2DBC
للحصول على أمثلة على استخدام هذه المكتبة في سياق التطبيق، قم بمراجعة نماذج التطبيقات الموجودة هنا.
تستخدم هذه المكتبة استراتيجية بيانات اعتماد التطبيق الافتراضية (ADC) لحل بيانات الاعتماد. يرجى الاطلاع على هذه التعليمات لمعرفة كيفية تعيين ADC (تطبيق Google Cloud مقابل التطوير المحلي، ومستخدم IAM مقابل بيانات اعتماد حساب الخدمة).
---
لإنشاء JAR كبير يحتوي على برنامج تشغيل JDBC مع تبعيات حزم مصنع المقبس، يمكنك إصدار أمر Maven التالي من الموقع الذي يحتوي على المشروع pom.xml:
mvn -P jar-with-dependencies clean package -DskipTests
سيؤدي هذا إلى إنشاء مجلد فرعي مستهدف داخل كل دليل من أدلة الوحدة. ضمن هذه الدلائل المستهدفة ستجد ملفات برنامج تشغيل JDBC.
مثال:
mysql-socket-factory-connector-j-8–1.8.0-jar-with-dependencies.jar postgres-socket-factory-1.8.0-jar-with-dependencies.jar
يدعم Java Connector تسجيل التصحيح الاختياري للمساعدة في تشخيص المشكلات المتعلقة بتحديث شهادة الخلفية. لتمكينه، أضف ما يلي إلى الملف /src/main/resources/application.yml
:
logging.level.root=DEBUG
ينشئ وكيل Cloud SQL اتصالات بمثيلات Cloud SQL باستخدام المنفذ 3307. قد تحتاج التطبيقات المحمية بواسطة جدار حماية إلى تكوينها للسماح بالاتصالات الصادرة على منفذ TCP 3307. عادةً ما يؤدي الاتصال المحظور بواسطة جدار الحماية إلى حدوث خطأ يشير إلى فشل الاتصال ( على سبيل المثال com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure
).
لتوصيل IntelliJ بمثيل Cloud SQL الخاص بك، ستحتاج إلى إضافة هذه المكتبة كجرة تحتوي على تبعيات في قسم "الملفات الإضافية" في صفحة إعدادات برنامج التشغيل. لم تعد الجرار الدهنية المعدة مسبقًا متوفرة (منذ الإصدار 1.14.0).
فيما يلي بعض النصائح حول استكشاف الأخطاء وإصلاحها لحل المشكلات الشائعة التي تظهر عند استخدام Java Connector:
تأكد من أنك تستخدم أحدث إصدار من Cloud SQL Connector وبرنامج تشغيل قاعدة البيانات لديك لتجنب حالات عدم التوافق. بعض الإصدارات الأقدم من برامج التشغيل غير مدعومة.
يوفر موصل Java ترخيصًا للاتصالات، ولكنه لا يوفر مسارات جديدة للاتصال. على سبيل المثال، للاتصال بمثيل Cloud SQL باستخدام عنوان IP خاص، يجب أن يتمتع تطبيقك بإمكانية الوصول إلى VPC بالفعل.
يستخدم هذا المشروع الإصدارات الدلالية، ويستخدم دورة الحياة التالية فيما يتعلق بدعم الإصدار الرئيسي:
نشط - تحصل الإصدارات النشطة على جميع الميزات الجديدة وإصلاحات الأمان (التي لن تؤدي إلى تغيير جذري). الإصدارات الرئيسية الجديدة مضمونة لتكون "نشطة" لمدة لا تقل عن سنة واحدة. مهمل - تستمر الإصدارات المهملة في الحصول على إصلاحات الأمان والأخطاء الهامة، ولكنها لا تتلقى ميزات جديدة. سيتم دعم الإصدارات المهملة بشكل علني لمدة عام واحد. غير مدعوم - أي إصدار رئيسي تم إهماله لمدة تزيد عن سنة واحدة يعتبر غير مدعوم بشكل عام.
نحن نختبر وندعم على الأقل أي إصدار LTS JDK مدعوم بشكل عام. سيتم اعتبار التغييرات في الإصدارات المدعومة تغييرًا طفيفًا، وسيتم إدراجها في ملاحظات الإصدار الحقيقي.
يهدف هذا المشروع إلى الحد الأدنى من إيقاع الإصدار الشهري. إذا لم تتم إضافة أي ميزات أو إصلاحات جديدة، فسيتم إصدار إصدار PATCH جديد بأحدث التبعيات.