সংযুক্ত পত্রক

সংযুক্ত পত্রক আপনাকে সরাসরি Google পত্রকের মধ্যে পেটাবাইট ডেটা বিশ্লেষণ করতে দেয়৷ আপনি আপনার স্প্রেডশীটগুলিকে একটি BigQuery ডেটা গুদাম বা লুকারের সাথে সংযুক্ত করতে পারেন এবং পিভট টেবিল, চার্ট এবং সূত্রের মতো পরিচিত পত্রক সরঞ্জামগুলি ব্যবহার করে বিশ্লেষণ করতে পারেন৷

একটি BigQuery ডেটা উৎস পরিচালনা করুন

এই বিভাগটি BigQuery Shakespeare পাবলিক ডেটাসেট ব্যবহার করে দেখায় কিভাবে সংযুক্ত শীট ব্যবহার করতে হয়। ডেটাসেটে নিম্নলিখিত তথ্য রয়েছে:

মাঠ টাইপ বর্ণনা
শব্দ STRING একটি কর্পাস থেকে বের করা একটি একক অনন্য শব্দ (যেখানে হোয়াইটস্পেস বিভেদক)।
শব্দ_গণনা INTEGER এই কর্পাসে এই শব্দটি যতবার উপস্থিত হয়।
কর্পাস STRING যে কাজ থেকে এই শব্দটি বের করা হয়েছে।
কর্পাস_তারিখ INTEGER যে বছর এই করপাস প্রকাশিত হয়েছিল।

আপনার অ্যাপ্লিকেশন যদি কোনো BigQuery Connected Sheets ডেটার জন্য অনুরোধ করে, তাহলে এটিকে একটি OAuth 2.0 টোকেন প্রদান করতে হবে যা একটি নিয়মিত Google Sheets API অনুরোধের জন্য প্রয়োজনীয় অন্যান্য স্কোপের পাশাপাশি bigquery.readonly সুযোগ প্রদান করে। আরও তথ্যের জন্য, Google পত্রক API স্কোপ নির্বাচন করুন দেখুন।

একটি ডেটা উৎস একটি বাহ্যিক অবস্থান নির্দিষ্ট করে যেখানে ডেটা পাওয়া যায়। তথ্য উৎস তারপর স্প্রেডশীট সাথে সংযুক্ত করা হয়.

একটি BigQuery ডেটা উৎস যোগ করুন

একটি ডেটা উৎস যোগ করতে, spreadsheets.batchUpdate পদ্ধতি ব্যবহার করে একটি AddDataSourceRequest সরবরাহ করুন। অনুরোধের অংশটি DataSource অবজেক্টের ধরণের একটি dataSource ক্ষেত্র নির্দিষ্ট করতে হবে।

"addDataSource":{
   "dataSource":{
      "spec":{
         "bigQuery":{
            "projectId":"PROJECT_ID",
            "tableSpec":{
               "tableProjectId":"bigquery-public-data",
               "datasetId":"samples",
               "tableId":"shakespeare"
            }
         }
      }
   }
}

একটি বৈধ Google ক্লাউড প্রকল্প ID দিয়ে PROJECT_ID প্রতিস্থাপন করুন।

একটি ডেটা উত্স তৈরি হওয়ার পরে, 500টি সারি পর্যন্ত একটি পূর্বরূপ দেওয়ার জন্য একটি সম্পর্কিত DATA_SOURCE শীট তৈরি করা হয়৷ পূর্বরূপ অবিলম্বে উপলব্ধ নয়. BigQuery ডেটা আমদানি করতে অ্যাসিঙ্ক্রোনাসভাবে একটি এক্সিকিউশন ট্রিগার করা হয়।

AddDataSourceResponse নিম্নলিখিত ক্ষেত্রগুলি ধারণ করে:

  • dataSource : তৈরি করা DataSource অবজেক্ট। dataSourceId হল একটি স্প্রেডশীট-স্কোপ বিশিষ্ট অনন্য ID। ডেটা উত্স থেকে প্রতিটি DataSource অবজেক্ট তৈরি করতে এটি জনবহুল এবং উল্লেখ করা হয়েছে।

  • dataExecutionStatus : প্রিভিউ শীটে BigQuery ডেটা ইম্পোর্ট করে এমন একটি এক্সিকিউশনের স্থিতি। আরও তথ্যের জন্য, ডেটা এক্সিকিউশন স্ট্যাটাস বিভাগটি দেখুন।

একটি BigQuery ডেটা উৎস আপডেট করুন বা মুছুন

spreadsheets.batchUpdate পদ্ধতি ব্যবহার করুন এবং সেই অনুযায়ী একটি UpdateDataSourceRequest বা DeleteDataSourceRequest অনুরোধ সরবরাহ করুন।

BigQuery ডেটা সোর্স অবজেক্ট ম্যানেজ করুন

একবার স্প্রেডশীটে একটি ডেটা উত্স যোগ করা হলে, এটি থেকে একটি ডেটা উত্স বস্তু তৈরি করা যেতে পারে। একটি ডেটা সোর্স অবজেক্ট হল একটি নিয়মিত শীট টুল যেমন পিভট টেবিল, চার্ট এবং সূত্র যা আপনার ডেটা বিশ্লেষণকে শক্তিশালী করার জন্য সংযুক্ত পত্রকের সাথে একত্রিত করা হয়।

চার ধরনের বস্তু আছে:

  • DataSource টেবিল
  • DataSource পিভট টেবিল
  • DataSource চার্ট
  • DataSource সূত্র

একটি BigQuery ডেটা সোর্স টেবিল যোগ করুন

পত্রক সম্পাদকে "এক্সট্রাক্ট" হিসাবে পরিচিত, টেবিল অবজেক্টটি ডেটা উৎস থেকে ডেটার একটি স্ট্যাটিক ডাম্প পত্রকে আমদানি করে৷ একটি পিভট টেবিলের মতো, টেবিলটি নির্দিষ্ট করা হয় এবং উপরের বাম ঘরে নোঙ্গর করা হয়।

নিম্নলিখিত কোড নমুনা দেখায় কিভাবে spreadsheets.batchUpdate পদ্ধতি এবং একটি UpdateCellsRequest ব্যবহার করে দুটি কলামের 1000 সারি পর্যন্ত ডেটা সোর্স টেবিল তৈরি করতে হয় ( word এবং word_count )।

"updateCells":{
   "rows":{
      "values":[
         {
            "dataSourceTable":{
               "dataSourceId":"DATA_SOURCE_ID",
               "columns":[
                  {
                     "name":"word"
                  },
                  {
                     "name":"word_count"
                  }
               ],
               "rowLimit":{
                  "value":1000
               },
               "columnSelectionType":"SELECTED"
            }
         }
      ]
   },
   "fields":"dataSourceTable"
}

DATA_SOURCE_ID একটি স্প্রেডশীট-স্কোপযুক্ত অনন্য আইডি দিয়ে প্রতিস্থাপন করুন যা ডেটা উত্স সনাক্ত করে।

ডেটা সোর্স টেবিল তৈরি হওয়ার পরে, ডেটা অবিলম্বে পাওয়া যায় না। পত্রক সম্পাদকে, এটি একটি পূর্বরূপ হিসাবে দেখানো হয়৷ BigQuery ডেটা আনতে আপনাকে ডেটা সোর্স টেবিল রিফ্রেশ করতে হবে। আপনি একই batchUpdate মধ্যে একটি RefreshDataSourceRequest উল্লেখ করতে পারেন। মনে রাখবেন যে সমস্ত ডেটা সোর্স অবজেক্ট একইভাবে কাজ করে। আরও তথ্যের জন্য, একটি ডেটা উৎস বস্তু রিফ্রেশ করুন দেখুন।

রিফ্রেশ সম্পূর্ণ হওয়ার পরে এবং BigQuery ডেটা আনার পরে, ডেটা সোর্স টেবিলটি দেখানো হিসাবে পপুলেট করা হয়:

ডাটা সোর্স টেবিল শেক্সপিয়ার পাবলিক থেকে ডেটা দেখাচ্ছে ডেটাসেট

একটি BigQuery ডেটা উৎস pivotTable যোগ করুন

একটি প্রচলিত পিভট টেবিলের বিপরীতে, একটি ডেটা উৎস পিভট টেবিল একটি ডেটা উৎস দ্বারা সমর্থিত এবং এটি কলামের নাম দ্বারা ডেটা উল্লেখ করে। নিম্নলিখিত কোড নমুনা দেখায় কিভাবে spreadsheets.batchUpdate পদ্ধতি ব্যবহার করতে হয় এবং একটি পিভট টেবিল তৈরি করতে একটি UpdateCellsRequest যাতে কর্পাস দ্বারা মোট শব্দ সংখ্যা দেখানো হয়।

"updateCells":{
   "rows":{
      "values":[
         {
            "pivotTable":{
               "dataSourceId":"DATA_SOURCE_ID",
               "rows":{
                  "dataSourceColumnReference":{
                     "name":"corpus"
                  },
                  "sortOrder":"ASCENDING"
               },
               "values":{
                  "summarizeFunction":"SUM",
                  "dataSourceColumnReference":{
                     "name":"word_count"
                  }
               }
            }
         }
      ]
   },
   "fields":"pivotTable"
    }

DATA_SOURCE_ID একটি স্প্রেডশীট-স্কোপযুক্ত অনন্য আইডি দিয়ে প্রতিস্থাপন করুন যা ডেটা উত্স সনাক্ত করে।

BigQuery ডেটা আনার পরে, ডেটা সোর্স পিভট টেবিলটি দেখানো হিসাবে পপুলেট করা হয়:

ডাটা সোর্স পিভট টেবিল শেক্সপিয়ার পাবলিক থেকে ডেটা দেখাচ্ছে ডেটাসেট

একটি BigQuery ডেটা উৎস চার্ট যোগ করুন

নিম্নলিখিত কোড নমুনা দেখায় কিভাবে spreadsheets.batchUpdate batchUpdate পদ্ধতি এবং একটি AddChartRequest ব্যবহার করে COLUMN-এর একটি chartType সহ একটি ডেটা সোর্স চার্ট তৈরি করতে, কর্পাস দ্বারা মোট শব্দ সংখ্যা দেখায়৷

"addChart":{
   "chart":{
      "spec":{
         "title":"Corpus by word count",
         "basicChart":{
            "chartType":"COLUMN",
            "domains":[
               {
                  "domain":{
                     "columnReference":{
                        "name":"corpus"
                     }
                  }
               }
            ],
            "series":[
               {
                  "series":{
                     "columnReference":{
                        "name":"word_count"
                     },
                     "aggregateType":"SUM"
                  }
               }
            ]
         }
      },
      "dataSourceChartProperties":{
         "dataSourceId":"DATA_SOURCE_ID"
      }
   }
}

DATA_SOURCE_ID একটি স্প্রেডশীট-স্কোপযুক্ত অনন্য আইডি দিয়ে প্রতিস্থাপন করুন যা ডেটা উত্স সনাক্ত করে।

BigQuery ডেটা আনার পরে, ডেটা উত্স চার্ট দেখানো হিসাবে রেন্ডার করা হয়:

ডাটা সোর্স চার্ট শেক্সপিয়ার পাবলিক থেকে ডেটা দেখাচ্ছে ডেটাসেট

একটি BigQuery ডেটা উৎস সূত্র যোগ করুন

নিম্নলিখিত কোড নমুনা দেখায় কিভাবে spreadsheets.batchUpdate পদ্ধতি এবং একটি UpdateCellsRequest ব্যবহার করে গড় শব্দ গণনা গণনা করার জন্য একটি ডেটা উৎস সূত্র তৈরি করতে হয়।

"updateCells":{
   "rows":[
      {
         "values":[
            {
               "userEnteredValue":{
                  "formulaValue":"=AVERAGE(shakespeare!word_count)"
               }
            }
         ]
      }
   ],
   "fields":"userEnteredValue"
}

BigQuery ডেটা আনার পরে, ডেটা উত্স সূত্রটি দেখানো হিসাবে পপুলেট করা হয়:

ডাটা সোর্স সূত্র শেক্সপিয়র পাবলিক থেকে ডেটা দেখাচ্ছে ডেটাসেট

একটি BigQuery ডেটা সোর্স অবজেক্ট রিফ্রেশ করুন

আপনি বর্তমান ডেটা সোর্স স্পেসিক্স এবং অবজেক্ট কনফিগারেশনের উপর ভিত্তি করে BigQuery থেকে সাম্প্রতিক ডেটা আনতে একটি ডেটা সোর্স অবজেক্ট রিফ্রেশ করতে পারেন। RefreshDataSourceRequest কল করার জন্য আপনি spreadsheets.batchUpdate পদ্ধতি ব্যবহার করতে পারেন। তারপর DataSourceObjectReferences অবজেক্ট ব্যবহার করে রিফ্রেশ করতে এক বা একাধিক অবজেক্ট রেফারেন্স নির্দিষ্ট করুন।

মনে রাখবেন যে আপনি একটি batchUpdate অনুরোধের মধ্যে ডেটা সোর্স অবজেক্ট তৈরি এবং রিফ্রেশ করতে পারেন।

একটি লুকার ডেটা উৎস পরিচালনা করুন

এই নির্দেশিকাটি দেখাবে কিভাবে একটি লুকার ডেটা উৎস যোগ করতে হয়, এটিকে আপডেট করতে বা মুছতে হয়, এটিতে একটি পিভট টেবিল তৈরি করতে হয় এবং এটি রিফ্রেশ করতে হয়।

যেকোনও লুকার কানেক্টেড শীট ডেটার জন্য অনুরোধ করা আপনার অ্যাপ্লিকেশানটি লুকারের সাথে আপনার বিদ্যমান Google অ্যাকাউন্ট লিঙ্কটি পুনরায় ব্যবহার করবে৷

একটি Looker ডেটা উৎস যোগ করুন

একটি ডেটা উৎস যোগ করতে, spreadsheets.batchUpdate পদ্ধতি ব্যবহার করে একটি AddDataSourceRequest সরবরাহ করুন। অনুরোধের অংশটি DataSource অবজেক্টের ধরণের একটি dataSource ক্ষেত্র নির্দিষ্ট করতে হবে।

"addDataSource":{
   "dataSource":{
      "spec":{
         "looker":{
            "instance_uri":"INSTANCE_URI",
            "model":"MODEL",
            "explore":"EXPLORE"
         }
      }
   }
}

INSTANCE_URI , MODEL এবং EXPLORE যথাক্রমে একটি বৈধ লুকার ইনস্ট্যান্স URI, মডেলের নাম এবং এক্সপ্লোর নাম দিয়ে প্রতিস্থাপন করুন।

একটি ডেটা উৎস তৈরি হওয়ার পরে, একটি সংশ্লিষ্ট DATA_SOURCE শীট তৈরি করা হয় যাতে নির্বাচিত এক্সপ্লোরের কাঠামোর একটি পূর্বরূপ প্রদান করা হয়, যার মধ্যে দৃশ্য, মাত্রা, পরিমাপ এবং যেকোনো ক্ষেত্রের বিবরণ রয়েছে।

AddDataSourceResponse নিম্নলিখিত ক্ষেত্রগুলি ধারণ করে:

  • dataSource : তৈরি করা DataSource অবজেক্ট। dataSourceId হল একটি স্প্রেডশীট-স্কোপ বিশিষ্ট অনন্য ID। ডেটা উত্স থেকে প্রতিটি DataSource অবজেক্ট তৈরি করতে এটি জনবহুল এবং উল্লেখ করা হয়েছে।

  • dataExecutionStatus : প্রিভিউ শীটে BigQuery ডেটা ইম্পোর্ট করে এমন একটি এক্সিকিউশনের স্থিতি। আরও তথ্যের জন্য, ডেটা এক্সিকিউশন স্ট্যাটাস বিভাগটি দেখুন।

একটি Looker ডেটা উৎস আপডেট বা মুছে দিন

spreadsheets.batchUpdate পদ্ধতি ব্যবহার করুন এবং সেই অনুযায়ী একটি UpdateDataSourceRequest বা DeleteDataSourceRequest অনুরোধ সরবরাহ করুন।

লুকার ডেটা সোর্স অবজেক্টগুলি পরিচালনা করুন

একবার স্প্রেডশীটে একটি ডেটা উত্স যোগ করা হলে, এটি থেকে একটি ডেটা উত্স বস্তু তৈরি করা যেতে পারে। Looker ডেটা উত্সের জন্য, আপনি এটি থেকে শুধুমাত্র একটি DataSource pivotTable অবজেক্ট তৈরি করতে পারেন।

লুকার ডেটা সোর্স থেকে DataSource সূত্র, নির্যাস এবং চার্ট তৈরি করা সম্ভব নয়।

একটি লুকার ডেটা সোর্স অবজেক্ট রিফ্রেশ করুন

বর্তমান ডেটা সোর্স স্পেক্স এবং অবজেক্ট কনফিগারেশনের উপর ভিত্তি করে লুকার থেকে সাম্প্রতিক ডেটা আনতে আপনি একটি ডেটা সোর্স অবজেক্ট রিফ্রেশ করতে পারেন। RefreshDataSourceRequest কল করার জন্য আপনি spreadsheets.batchUpdate পদ্ধতি ব্যবহার করতে পারেন। তারপর DataSourceObjectReferences অবজেক্ট ব্যবহার করে রিফ্রেশ করতে এক বা একাধিক অবজেক্ট রেফারেন্স নির্দিষ্ট করুন।

মনে রাখবেন যে আপনি একটি batchUpdate অনুরোধের মধ্যে ডেটা সোর্স অবজেক্ট তৈরি এবং রিফ্রেশ করতে পারেন।

ডেটা এক্সিকিউশন স্ট্যাটাস

আপনি যখন ডেটা সোর্স তৈরি করেন বা ডেটা সোর্স অবজেক্ট রিফ্রেশ করেন, তখন BigQuery বা Looker থেকে ডেটা আনার জন্য একটি ব্যাকগ্রাউন্ড এক্সিকিউশন তৈরি করা হয় এবং DataExecutionStatus সম্বলিত একটি প্রতিক্রিয়া ফেরত দেওয়া হয়। যদি সম্পাদন সফলভাবে শুরু হয়, DataExecutionState সাধারণত RUNNING অবস্থায় থাকে।

যেহেতু প্রক্রিয়াটি অ্যাসিঙ্ক্রোনাস, তাই আপনার অ্যাপ্লিকেশনটি পর্যায়ক্রমে ডেটা উৎস বস্তুর স্থিতি পুনরুদ্ধার করতে একটি পোলিং মডেল প্রয়োগ করা উচিত। spreadsheets.get পদ্ধতিটি ব্যবহার করুন যতক্ষণ না স্ট্যাটাসটি SUCCEEDED বা FAILED অবস্থায় ফিরে আসে। বেশিরভাগ ক্ষেত্রেই এক্সিকিউশন দ্রুত সম্পন্ন হয়, তবে এটি আপনার ডেটা উৎসের জটিলতার উপর নির্ভর করে। সাধারণত মৃত্যুদন্ড 10 মিনিটের বেশি হয় না।