الوصول الآمن إلى بيانات GCS

1. في Google Cloud Console، انتقل إلى IAM & Admin → Service Accounts

2. انقر على Service accounts في القائمة الجانبية اليسرى، ثم انقر على Create service account:

أدخل اسمًا ووصفًا لحساب الخدمة، على سبيل المثال:

Service account name: clickhouse-gcs-access (or your preferred name)
Service account description: Service account for ClickHouse Cloud to access GCS buckets

انقر على Create and continue

امنح حساب الخدمة دور Storage Object User:

يوفّر هذا الدور إذن القراءة والكتابة لكائنات GCS

انقر على Continue، ثم Done

دوّن عنوان البريد الإلكتروني الخاص بحساب الخدمة:

يمكنك منح الإذن إمّا على مستوى المشروع أو على مستوى حاوية تخزين فردية.

الخيار 1: منح الإذن إلى حاويات تخزين محددة (موصى به)

1. انتقل إلى Cloud Storage → Buckets
2. انقر على حاوية التخزين التي تريد منح الإذن لها
3. انتقل إلى علامة التبويب Permissions
4. ضمن "Permissions"، انقر على Grant access للهوية التي أُنشئت في الخطوات السابقة
5. في حقل "New principals"، أدخل البريد الإلكتروني لحساب الخدمة
6. حدِّد الدور المناسب:

• Storage Object User للوصول للقراءة والكتابة
• Storage Object Viewer للوصول للقراءة فقط

7. انقر على Save
8. كرر ذلك لأي حاويات تخزين إضافية

الخيار 2: منح الإذن على مستوى المشروع

1. انتقل إلى IAM & Admin → IAM
2. انقر على Grant access
3. أدخل البريد الإلكتروني لحساب الخدمة في حقل New principals
4. حدِّد Storage Object User (أو Storage Object Viewer لوصول القراءة فقط)
5. انقر على SAVE

انتقل إلى Cloud Storage → Settings → Interoperability:

إذا لم يظهر قسم "Access keys"، فانقر على Enable interoperability access

ضمن "Access keys for service accounts"، انقر على Create a key for a service account:

حدّد حساب الخدمة الذي أنشأته سابقًا (على سبيل المثال clickhouse-gcs-access@your-project.iam.gserviceaccount.com)

انقر على Create key:

سيُعرَض مفتاح HMAC. احفظ كلاً من Access Key وSecret فورًا - فلن تتمكن من عرض الـ secret مرة أخرى.

تظهر مفاتيح مثال أدناه:

Access Key: GOOG1EF4YBJVNFQ2YGCP3SLV4Y7CMFHW7HPC6EO7RITLJDDQ75639JK56SQVD
Secret: nFy6DFRr4sM9OnV6BG4FtWVPR25JfqpmcdZ6w9nV

استخدام HMAC keys مع ClickHouse Cloud

يمكنك الآن استخدام بيانات اعتماد HMAC للوصول إلى GCS من ClickHouse Cloud. ولهذا، استخدم table function الخاصة بـ GCS:

SELECT *
FROM gcs(
    'https://storage.googleapis.com/clickhouse-docs-example-bucket/epidemiology.csv',
    'GOOG1E...YOUR_ACCESS_KEY',
    'YOUR_SECRET_KEY',
    'CSVWithNames'
);

استخدم أحرف البدل مع ملفات متعددة:

SELECT *
FROM gcs(
'https://storage.googleapis.com/clickhouse-docs-example-bucket/*.parquet',
'GOOG1E...YOUR_ACCESS_KEY',
'YOUR_SECRET_KEY',
'Parquet'
);

مصادقة HMAC في ClickPipes for GCS

تستخدم ClickPipes مفاتيح HMAC ‏(Hash-based Message Authentication Code) للمصادقة مع Google Cloud Storage.

عند إعداد ClickPipe لـ GCS:

1. حدِّد Credentials ضمن Authentication method أثناء إعداد ClickPipe
2. أدخِل بيانات اعتماد HMAC التي حصلت عليها في الخطوات السابقة

يجب أن تكون مفاتيح HMAC مرتبطة بحساب خدمة لديه الدور roles/storage.objectViewer، والذي يتضمن:

• storage.objects.list: لسرد الكائنات في الحاوية
• storage.objects.get: لجلب الكائنات/قراءتها