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

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

একটি BigQuery ডেটা সোর্স পরিচালনা করুন

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

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

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

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

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

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

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

PROJECT_ID পরিবর্তে একটি বৈধ Google ক্লাউড প্রোজেক্ট আইডি দিন।

একটি ডেটা সোর্স তৈরি করার পরে, একটি সংশ্লিষ্ট DATA_SOURCE শিট তৈরি করা হয় যা সর্বাধিক ৫০০টি সারির প্রিভিউ প্রদান করে। প্রিভিউটি তাৎক্ষণিকভাবে উপলব্ধ হয় না। BigQuery ডেটা আমদানি করার জন্য অ্যাসিঙ্ক্রোনাসভাবে একটি এক্সিকিউশন ট্রিগার করা হয়।

AddDataSourceResponse এ নিম্নলিখিত ক্ষেত্রগুলি রয়েছে:

• dataSource : তৈরি করা DataSource অবজেক্ট। dataSourceId হল একটি স্প্রেডশিট-স্কোপযুক্ত অনন্য আইডি। এটি ডেটা সোর্স থেকে প্রতিটি DataSource অবজেক্ট তৈরি করার জন্য পপুলেট এবং রেফারেন্স করা হয়।

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

BigQuery ডেটা সোর্স আপডেট করুন বা মুছে ফেলুন

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

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

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

চার ধরণের বস্তু রয়েছে:

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

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

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

নিচের কোড নমুনাটি দেখায় কিভাবে spreadsheets.batchUpdate পদ্ধতি এবং UpdateCellsRequest ব্যবহার করে দুটি কলামের ( 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 পদ্ধতি এবং একটি 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 অনুরোধের মধ্যে ডেটা সোর্স অবজেক্ট তৈরি এবং রিফ্রেশ উভয়ই করতে পারেন।

একটি লুকার ডেটা সোর্স পরিচালনা করুন

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

আপনার Looker Connected Sheets ডেটার জন্য অনুরোধ করা আবেদনটি, Looker-এর সাথে আপনার বিদ্যমান Google অ্যাকাউন্টের লিঙ্কটি পুনরায় ব্যবহার করবে।

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

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

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

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

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

AddDataSourceResponse এ নিম্নলিখিত ক্ষেত্রগুলি রয়েছে:

• dataSource : তৈরি করা DataSource অবজেক্ট। dataSourceId হল একটি স্প্রেডশিট-স্কোপযুক্ত অনন্য আইডি। এটি ডেটা সোর্স থেকে প্রতিটি DataSource অবজেক্ট তৈরি করার জন্য পপুলেট এবং রেফারেন্স করা হয়।

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

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

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

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

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

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

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

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

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

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

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

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

সম্পর্কিত বিষয়

• Google Sheets API স্কোপ বেছে নিন
• Google Sheets-এ BigQuery ডেটা দিয়ে শুরু করুন
• BigQuery ডকুমেন্টেশন
• BigQuery: সংযুক্ত পত্রক ব্যবহার করা
• কানেক্টেড শিটস ভিডিও টিউটোরিয়াল
• লুকারের জন্য সংযুক্ত পত্রক ব্যবহার করা
• লুকারের ভূমিকা