البدء

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

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

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

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

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

أمثلة على gsutil

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

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

يسهل أيضًا تنزيل ملف باتّباع الخطوات التالية:

يمكنك نسخ ملفاتك من حِزم Google المتفرقة في DT إلى حزمة Google API GCS الخاصة بك باستخدام نص برمجي لواجهة سطر الأوامر في نظام التشغيل 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.
• انقر على "مجموعاتي" واختَر المجموعة التي تستخدمها لإدارة إذن الوصول إلى حزمة Cloud Storage في "إدارة بيانات Google" الإصدار 2.0
• انقر على "إدارة".
• لا تنقر على "دعوة الأعضاء"!
• انقر على "إضافة الأعضاء مباشرةً".
• انسخ عنوان البريد الإلكتروني لحساب الخدمة من الخطوة السابقة إلى مربّع الأعضاء.
• اختَر "عدم تلقّي بريد إلكتروني"
• انقر على الزر "إضافة"

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

النطاق

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

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

StorageScopes.DEVSTORAGE_READ_ONLY