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

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

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

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

একটি ডেটা সোর্স নিয়ে কাজ করা

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

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

একটি বৈধ Google ক্লাউড প্রকল্প আইডি দিয়ে নীচে <YOUR_PROJECT_ID> প্রতিস্থাপন করুন।

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

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

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

  • ডেটাসোর্স : নতুন তৈরি করা ডেটা সোর্স। ডেটাসোর্সআইডিও জনবহুল এবং ডেটা উৎস থেকে প্রতিটি ডেটাসোর্স অবজেক্ট তৈরি করতে উল্লেখ করা হবে।

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

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

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

ডেটাসোর্স অবজেক্টের সাথে কাজ করা

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

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

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

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

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

এই উদাহরণে, আমরা ব্যাচআপডেট পদ্ধতি ব্যবহার করি এবং 1000টি সারি পর্যন্ত দুটি কলাম word এবং word_count এর একটি ডেটা সোর্স টেবিল তৈরি করার জন্য একটি updateCells অনুরোধ সরবরাহ করি

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

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

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

শেক্সপিয়ার ডেটাসেট থেকে ডেটা দেখানো একটি ডেটা উত্স টেবিলের স্ক্রিনশট

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

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

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

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

শেক্সপিয়ার ডেটাসেট থেকে ডেটা দেখানো একটি ডেটা উৎস পিভটের স্ক্রিনশট

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

এই উদাহরণটি COLUMN প্রকার সহ একটি ডেটা উৎস চার্ট তৈরি করে, কর্পাস দ্বারা মোট শব্দ সংখ্যা দেখায়।

"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":"<YOUR_DATA_SOURCE_ID>"
      }
   }
}

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

শেক্সপিয়ার ডেটাসেট থেকে ডেটা দেখানো একটি ডেটা উৎস চার্টের স্ক্রিনশট

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

এই উদাহরণটি গড় শব্দ গণনা গণনা করার জন্য একটি ডেটা উৎস সূত্র তৈরি করে।

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

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

শেক্সপিয়ার ডেটাসেট থেকে ডেটা দেখানো একটি ডেটা উৎস সূত্রের স্ক্রিনশট

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

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

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

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

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

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