البدء

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

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

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

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

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

أمثلة على أداة gsutil

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

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

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

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 المكتبة.

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

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

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

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

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

النطاق

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

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

StorageScopes.DEVSTORAGE_READ_ONLY