دليل البدء

عند العمل مع فريق المبيعات أو فريق الدعم لإعداد الوصول إلى الإصدار 2.0 من "نقل البيانات"، سيتم تزويدك باسم حزمة. عليك توفير جهة اتصال للمبيعات في مجموعات Google تمكِّنك من التحكُّم في الوصول إلى ملفات بياناتك في Google Cloud Storage.

يمكنك اختيار الوصول إلى بياناتك باستخدام أداة مساعدة أو يمكنك كتابة الرمز الخاص بك.

الوصول إلى البيانات باستخدام gsutil

أداة gsutil هي تطبيق سطر أوامر، مكتوب بلغة Python، يتيح لك الوصول إلى بياناتك بدون الحاجة إلى تنفيذ أي ترميز. ويمكنك مثلاً استخدام gsutil كجزء من نص برمجي أو ملف مجمّع بدلاً من إنشاء تطبيقات مخصّصة.

لبدء استخدام gsutil، يمكنك قراءة وثائق gsutil. وستطلب منك الأداة بيانات الاعتماد عند استخدامها لأول مرة ثم تخزِّنها لاستخدامها في وقت لاحق.

أمثلة على gsutil

يمكنك إدراج جميع الملفات باستخدام gsutil على النحو التالي:

gsutil ls gs://[bucket_name]/[object name/file name]

تستخدم أداة gsutil الكثير من البنية نفسها مثل UNIX، بما في ذلك حرف البدل (*)، حتى تتمكّن من إدراج جميع ملفات Networkimpression:

gsutil ls gs://[bucket_name]/dcm_account6837_impression_*

من السهل أيضًا تنزيل ملف:

gsutil cp gs://[bucket_name]/dcm_account6837_impression_2015120100.log.gz

يمكنك نسخ ملفاتك من حزمة Google DT الفرعية إلى حزمة Google GCS Bucket باستخدام نص برمجي من Unix Shell، هناك خياران:

  • في أداة gsutil، إذا كنت تستخدم نظام Unix، يمكنك تشغيل ما يلي لجميع الحِزم يوميًا:

    $ day=$(date --date="1 days ago" +"%m-%d-%Y")
$ gsutil -m cp gs://{<dcmhashid_A>,<dcmhashid_B>,etc.}/*$day*.log.gz gs://<client_bucket>/

  • بدلاً من ذلك، هناك حل أصعب قليلاً من خلال استخدام ملف bash:

    #!/bin/bash

set -x

buckets={dfa_-hasid_A dfa_-hashid_B,...} #include all hash ids
day=$(date --date="1 days ago" +"%m-%d-%Y")
for b in ${buckets[@]}; do /
    gsutil -m cp gs://$b/*$day*.log.gz gs:/// /
done

الوصول إلى البيانات آليًا

تتضمّن خدمة Google Cloud Storage واجهات برمجة تطبيقات وعيّنات للعديد من لغات البرمجة، ما يتيح لك الوصول إلى بياناتك بطريقة آلية. في ما يلي الخطوات التي يجب اتّباعها في الإصدار 2.0 من "نقل البيانات" الذي يجب اتخاذه لإنشاء عملية تكامل نشطة.

الحصول على حساب خدمة

لبدء استخدام الإصدار 2.0 من أداة "نقل البيانات"، عليك أولاً استخدام أداة الإعداد التي ترشدك خلال عملية إنشاء مشروع في وحدة تحكّم Google API وتفعيل واجهة برمجة التطبيقات وإنشاء بيانات الاعتماد.

لإعداد حساب خدمة جديد، يُرجى اتّباع الخطوات التالية:

  1. انقر على إنشاء بيانات اعتماد &gt؛ مفتاح حساب الخدمة.
  2. اختَر ما إذا كنت تريد تنزيل المفتاح العام/خاص لحساب الخدمة كملف P12 عادي، أو كملف JSON يمكن تحميله من خلال مكتبة برنامج Google API.

يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على جهازك، ويعد هذا الزوج هو النسخة الوحيدة من هذا المفتاح. وأنت مسؤول عن تخزينه بأمان.

احرِص على إبقاء هذه النافذة مفتوحة، وستحتاج إلى البريد الإلكتروني لحساب الخدمة في الخطوة التالية.

إضافة حساب خدمة إلى مجموعتك

  • انتقِل إلى مجموعة Google.
  • انقر على "مجموعاتي"، واختَر المجموعة التي تستخدمها لإدارة الوصول إلى حزمة حزمة Cloud v2.0 Cloud Storage.
  • انقر على "إدارة".
  • لا تنقر على "دعوة الأعضاء".
  • انقر على "إضافة أعضاء" مباشرةً
  • انسخ البريد الإلكتروني لحساب الخدمة من الخطوة السابقة إلى مربّع الأعضاء.
  • اختيار "بلا عنوان بريد إلكتروني"
  • النقر على الزر "إضافة"

نقرتُ عن طريق الخطأ على "دعوة الأعضاء".

النطاق

يجب أن تكون أي نطاقات يتم تمريرها إلى Cloud Storage للقراءة فقط

على سبيل المثال، عند استخدام مكتبة عميل Java، يكون النطاق الصحيح للاستخدام هو: 

StorageScopes.DEVSTORAGE_READ_ONLY