Class DataSourceTable

ডেটা সোর্স টেবিল

বিদ্যমান ডেটা সোর্স টেবিল অ্যাক্সেস এবং পরিবর্তন করুন। একটি নতুন শীটে একটি নতুন ডেটা সোর্স টেবিল তৈরি করতে, Spreadsheet.insertSheetWithDataSourceTable(spec) ব্যবহার করুন।

শুধুমাত্র BigQuery ডেটা উৎসের সাথে এই ক্লাসটি ব্যবহার করুন।

এই উদাহরণটি দেখায় কিভাবে একটি নতুন ডেটা সোর্স টেবিল তৈরি করতে হয়।

SpreadsheetApp.enableBigQueryExecution();
var spreadsheet = SpreadsheetApp.getActive();
var spec = SpreadsheetApp.newDataSourceSpec()
           .asBigQuery()
           .setProjectId('big_query_project')
           .setRawQuery('select @FIELD from table limit @LIMIT')
           .setParameterFromCell('FIELD', 'Sheet1!A1')
           .setParameterFromCell('LIMIT', 'namedRangeCell')
           .build();
// Starts data execution asynchronously.
var dataSheet = spreadsheet.insertSheetWithDataSourceTable(spec);
var dataSourceTable = dataSheet.getDataSourceTables()[0];
// waitForCompletion() blocks script execution until data execution completes.
dataSourceTable.waitForCompletion(60);
// Check status after execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());

এই উদাহরণটি দেখায় কিভাবে একটি ডেটা উৎস সম্পাদনা করতে হয়।

SpreadsheetApp.enableBigQueryExecution();
var dataSheet = SpreadsheetApp.getActive().getSheetByName("Data Sheet 1");
var dataSourceTable = dataSheet.getDataSourceTables()[0];
var dataSource = dataSourceTable.getDataSource();
var newSpec = dataSource.getSpec()
              .copy()
              .asBigQuery()
              .setRawQuery('select name from table limit 2')
              .removeAllParameters()
              .build();
// Updates data source specification and starts data execution asynchronously.
dataSource.updateSpec(newSpec);
// Check status during execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());
// waitForCompletion() blocks script execution until data execution completes.
dataSourceTable.waitForCompletion(60);
// Check status after execution.
Logger.log("Data execution state: %s.", dataSourceTable.getStatus().getExecutionState());

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
addColumns(columnNames) DataSourceTable ডাটা সোর্স টেবিলে কলাম যোগ করে।
addFilter(columnName, filterCriteria) DataSourceTable ডেটা উৎস সারণীতে প্রয়োগ করা একটি ফিল্টার যোগ করে।
addSortSpec(columnName, ascending) DataSourceTable ডেটা উৎস সারণীতে একটি কলামে একটি সাজানোর বৈশিষ্ট্য যোগ করে।
addSortSpec(columnName, sortOrder) DataSourceTable ডেটা উৎস সারণীতে একটি কলামে একটি সাজানোর বৈশিষ্ট্য যোগ করে।
cancelDataRefresh() DataSourceTable এই বস্তুর সাথে যুক্ত ডেটা রিফ্রেশ বাতিল করে যদি এটি বর্তমানে চলমান থাকে।
forceRefreshData() DataSourceTable বর্তমান অবস্থা নির্বিশেষে এই বস্তুর ডেটা রিফ্রেশ করে।
getColumns() DataSourceTableColumn[] ডেটা উত্স টেবিলে যোগ করা সমস্ত ডেটা উত্স কলাম পায়৷
getDataSource() DataSource বস্তুর সাথে লিঙ্ক করা ডেটা উৎস পায়।
getFilters() DataSourceTableFilter[] ডেটা উত্স টেবিলে প্রয়োগ করা সমস্ত ফিল্টার ফেরত দেয়।
getRange() Range এই ডাটা সোর্স টেবিল স্প্যান Range পায়।
getRowLimit() Integer ডেটা উৎস টেবিলের জন্য সারি সীমা প্রদান করে।
getSortSpecs() SortSpec[] ডাটা সোর্স টেবিলে সব সাজানোর চশমা পায়।
getStatus() DataExecutionStatus অবজেক্টের ডেটা এক্সিকিউশন স্ট্যাটাস পায়।
isSyncingAllColumns() Boolean তথ্য উৎস সারণী সংশ্লিষ্ট ডেটা উৎসের সমস্ত কলাম সিঙ্ক করছে কিনা তা দেখায়।
refreshData() DataSourceTable বস্তুর ডেটা রিফ্রেশ করে।
removeAllColumns() DataSourceTable ডেটা সোর্স টেবিলের সমস্ত কলাম সরিয়ে দেয়।
removeAllSortSpecs() DataSourceTable ডাটা সোর্স টেবিলের সমস্ত সাজানোর স্পেস সরিয়ে দেয়।
setRowLimit(rowLimit) DataSourceTable ডেটা সোর্স টেবিলের জন্য সারি সীমা আপডেট করে।
syncAllColumns() DataSourceTable সংশ্লিষ্ট ডেটা সোর্সের সমস্ত বর্তমান এবং ভবিষ্যতের কলামগুলিকে ডেটা সোর্স টেবিলে সিঙ্ক করুন।
waitForCompletion(timeoutInSeconds) DataExecutionStatus বর্তমান এক্সিকিউশন সম্পূর্ণ না হওয়া পর্যন্ত অপেক্ষা করুন, প্রদত্ত সেকেন্ডের সংখ্যক পরে টাইমিং আউট।

বিস্তারিত ডকুমেন্টেশন

addColumns(columnNames)

ডাটা সোর্স টেবিলে কলাম যোগ করে।

পরামিতি

নাম টাইপ বর্ণনা
columnNames String[] কলামের নামের তালিকা যোগ করতে হবে।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স টেবিল, চেইনিংয়ের জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addFilter(columnName, filterCriteria)

ডেটা উৎস সারণীতে প্রয়োগ করা একটি ফিল্টার যোগ করে।

পরামিতি

নাম টাইপ বর্ণনা
columnName String এই ফিল্টারটি প্রয়োগ করার জন্য কলামের নাম।
filterCriteria FilterCriteria ফিল্টারের মানদণ্ড প্রয়োগ করতে হবে।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স টেবিল, চেইনিংয়ের জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addSortSpec(columnName, ascending)

ডেটা উৎস সারণীতে একটি কলামে একটি সাজানোর বৈশিষ্ট্য যোগ করে।

পরামিতি

নাম টাইপ বর্ণনা
columnName String সাজানোর জন্য কলামের নাম।
ascending Boolean true হলে, কলামটিকে আরোহী ক্রমে সাজান; false হলে, কলামটি নিচের ক্রমে সাজান।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স শীট, চেইন করার জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addSortSpec(columnName, sortOrder)

ডেটা উৎস সারণীতে একটি কলামে একটি সাজানোর বৈশিষ্ট্য যোগ করে।

পরামিতি

নাম টাইপ বর্ণনা
columnName String সাজানোর জন্য কলামের নাম।
sortOrder SortOrder সাজানোর ক্রম।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স শীট, চেইন করার জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

cancelDataRefresh()

এই বস্তুর সাথে যুক্ত ডেটা রিফ্রেশ বাতিল করে যদি এটি বর্তমানে চলমান থাকে।

এই উদাহরণটি দেখায় কিভাবে একটি সূত্র রিফ্রেশ বাতিল করতে হয়।

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

ডাটা সোর্স টাইপ সক্রিয় না থাকলে একটি ব্যতিক্রম থ্রো করে। SpreadsheetApp#enable...Execution() পদ্ধতি ব্যবহার করুন নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্ষম করতে।

প্রত্যাবর্তন

DataSourceTable — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

forceRefreshData()

বর্তমান অবস্থা নির্বিশেষে এই বস্তুর ডেটা রিফ্রেশ করে। আরো বিস্তারিত জানার জন্য refreshData() দেখুন। আপনি যদি এই বস্তুর বর্তমানে চলমান রিফ্রেশ বাতিল করতে চান, cancelDataRefresh() দেখুন।

ডাটা সোর্স টাইপ সক্রিয় না থাকলে একটি ব্যতিক্রম থ্রো করে। SpreadsheetApp#enable...Execution() পদ্ধতি ব্যবহার করুন নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্ষম করতে।

প্রত্যাবর্তন

DataSourceTable — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getColumns()

ডেটা উত্স টেবিলে যোগ করা সমস্ত ডেটা উত্স কলাম পায়৷

প্রত্যাবর্তন

DataSourceTableColumn[] — ডেটা সোর্স টেবিল কলামের একটি তালিকা।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDataSource()

বস্তুর সাথে লিঙ্ক করা ডেটা উৎস পায়।

প্রত্যাবর্তন

DataSource — ডাটা সোর্স।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFilters()

ডেটা উত্স টেবিলে প্রয়োগ করা সমস্ত ফিল্টার ফেরত দেয়।

প্রত্যাবর্তন

DataSourceTableFilter[] — ডেটা সোর্স টেবিলে প্রয়োগ করা সমস্ত ফিল্টারের একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

এই ডাটা সোর্স টেবিল স্প্যান Range পায়।

প্রত্যাবর্তন

Range — পরিসর।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRowLimit()

ডেটা উৎস টেবিলের জন্য সারি সীমা প্রদান করে।

প্রত্যাবর্তন

Integer — ডেটা সোর্স টেবিলের জন্য সারি সীমা, বা null যদি কোনো সীমা সেট করা না থাকে এবং টেবিলটি Google পত্রক UI এর মতো ডিফল্ট সর্বোচ্চ সীমা ব্যবহার করে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSortSpecs()

ডাটা সোর্স টেবিলে সব সাজানোর চশমা পায়।

প্রত্যাবর্তন

SortSpec[] — সাজানোর চশমার তালিকা।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getStatus()

অবজেক্টের ডেটা এক্সিকিউশন স্ট্যাটাস পায়।

প্রত্যাবর্তন

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

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isSyncingAllColumns()

তথ্য উৎস সারণী সংশ্লিষ্ট ডেটা উৎসের সমস্ত কলাম সিঙ্ক করছে কিনা তা দেখায়।

প্রত্যাবর্তন

Boolean — যদি ডেটা সোর্স টেবিল সংশ্লিষ্ট ডেটা সোর্সের সমস্ত কলাম সিঙ্ক করে থাকে তাহলে True , অথবা অন্যথায় false

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

refreshData()

বস্তুর ডেটা রিফ্রেশ করে।

বর্তমানে error অবস্থায় থাকলে একটি ব্যতিক্রম নিক্ষেপ করে। স্পেসিফিকেশন আপডেট করতে DataSource#updateSpec() ব্যবহার করুন। ডেটা উত্সে অপ্রত্যাশিত সম্পাদনা প্রতিরোধ করতে forceRefreshData() এর চেয়ে পদ্ধতিটিকে পছন্দ করা হয়।

ডাটা সোর্স টাইপ সক্রিয় না থাকলে একটি ব্যতিক্রম থ্রো করে। SpreadsheetApp#enable...Execution() পদ্ধতি ব্যবহার করুন নির্দিষ্ট ডেটা সোর্স টাইপের জন্য ডেটা এক্সিকিউশন সক্ষম করতে।

প্রত্যাবর্তন

DataSourceTable — ডেটা অবজেক্ট।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeAllColumns()

ডেটা সোর্স টেবিলের সমস্ত কলাম সরিয়ে দেয়।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স টেবিল, চেইনিংয়ের জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeAllSortSpecs()

ডাটা সোর্স টেবিলের সমস্ত সাজানোর স্পেস সরিয়ে দেয়।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স শীট, চেইন করার জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRowLimit(rowLimit)

ডেটা সোর্স টেবিলের জন্য সারি সীমা আপডেট করে। প্রদত্ত সারি সীমা null হলে, Google পত্রক UI-এর মতো ডিফল্ট সর্বোচ্চ সারি সীমা ব্যবহার করতে ডেটা উৎস সারণী আপডেট করে।

পরামিতি

নাম টাইপ বর্ণনা
rowLimit Integer ডেটা টেবিলের জন্য নতুন সারি সীমা। null হলে, ডিফল্ট সারি সীমা ব্যবহার করতে টেবিল আপডেট করে।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স টেবিল, চেইনিংয়ের জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

syncAllColumns()

সংশ্লিষ্ট ডেটা সোর্সের সমস্ত বর্তমান এবং ভবিষ্যতের কলামগুলিকে ডেটা সোর্স টেবিলে সিঙ্ক করুন।

প্রত্যাবর্তন

DataSourceTable — ডাটা সোর্স টেবিল, চেইনিংয়ের জন্য।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

waitForCompletion(timeoutInSeconds)

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

পরামিতি

নাম টাইপ বর্ণনা
timeoutInSeconds Integer ডেটা এক্সিকিউশনের জন্য অপেক্ষা করার সময়, সেকেন্ডে। সর্বোচ্চ 300 সেকেন্ড।

প্রত্যাবর্তন

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

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets