الخطوات الأولى

عندما تعمل مع جهة اتصال المبيعات أو الدعم لإعداد إمكانية الوصول إلى الإصدار 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

يمكنك نسخ ملفاتك من حِزم DT Google الموزَّعة إلى حزمة GCS الخاصة بك في Google API. باستخدام نص هيكل نظام التشغيل Unix، هناك خياران:

  • في 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. انقر على إنشاء بيانات اعتماد > مفتاح حساب الخدمة
  2. اختَر ما إذا كنت تريد تنزيل المفتاح العام/الخاص لحساب الخدمة كملف P12 عادي أو كملف JSON يمكن تحميله من خلال مكتبة العميل لـ Google API .

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

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

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

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

نقرت بدون قصد على "دعوة أعضاء"

النطاق

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

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

StorageScopes.DEVSTORAGE_READ_ONLY