Class DataSourceTable

তথ্য উৎস সারণী

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

শুধুমাত্র BigQuery ডেটা সোর্স দিয়ে এই ক্লাসটি ব্যবহার করুন।

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

SpreadsheetApp.enableBigQueryExecution();
const spreadsheet = SpreadsheetApp.getActive();
const 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.
const dataSheet = spreadsheet.insertSheetWithDataSourceTable(spec);
const 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();
const dataSheet = SpreadsheetApp.getActive().getSheetByName('Data Sheet 1');
const dataSourceTable = dataSheet.getDataSourceTables()[0];
const dataSource = dataSourceTable.getDataSource();
const 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(),
);

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Columns(columnNames) Data Source Table ডেটা সোর্স টেবিলে কলাম যোগ করে।
add Filter(columnName, filterCriteria) Data Source Table ডেটা সোর্স টেবিলে প্রয়োগ করা একটি ফিল্টার যোগ করে।
add Sort Spec(columnName, ascending) Data Source Table ডেটা সোর্স টেবিলের একটি কলামে একটি সাজানোর স্পেক যোগ করে।
add Sort Spec(columnName, sortOrder) Data Source Table ডেটা সোর্স টেবিলের একটি কলামে একটি সাজানোর স্পেক যোগ করে।
cancel Data Refresh() Data Source Table এই অবজেক্টটি বর্তমানে চলমান থাকলে এর সাথে সম্পর্কিত ডেটা রিফ্রেশ বাতিল করে।
force Refresh Data() Data Source Table বর্তমান অবস্থা নির্বিশেষে এই বস্তুর ডেটা রিফ্রেশ করে।
get Columns() Data Source Table Column[] ডেটা সোর্স টেবিলে সমস্ত ডেটা সোর্স কলাম যোগ করে।
get Data Source() Data Source বস্তুটি যে ডেটা সোর্সের সাথে সংযুক্ত তা পায়।
get Filters() Data Source Table Filter[] ডেটা সোর্স টেবিলে প্রয়োগ করা সকল ফিল্টার ফেরত পাঠায়।
get Range() Range এই ডেটা সোর্স টেবিলের ব্যাপ্তি কত Range পায়।
get Row Limit() Integer|null ডাটা সোর্স টেবিলের জন্য সারি সীমা প্রদান করে।
get Sort Specs() Sort Spec[] ডেটা সোর্স টেবিলের সমস্ত ধরণের স্পেসিফিকেশন পায়।
get Status() Data Execution Status অবজেক্টের ডেটা এক্সিকিউশন স্ট্যাটাস পায়।
is Syncing All Columns() Boolean ডেটা সোর্স টেবিলটি সংশ্লিষ্ট ডেটা সোর্সের সমস্ত কলাম সিঙ্ক করছে কিনা তা ফেরত পাঠায়।
refresh Data() Data Source Table বস্তুর ডেটা রিফ্রেশ করে।
remove All Columns() Data Source Table ডেটা সোর্স টেবিলের সকল কলাম মুছে ফেলে।
remove All Sort Specs() Data Source Table ডেটা সোর্স টেবিলের সমস্ত সাজানোর স্পেসিফিকেশন সরিয়ে দেয়।
set Row Limit(rowLimit) Data Source Table ডেটা সোর্স টেবিলের জন্য সারি সীমা আপডেট করে।
sync All Columns() Data Source Table সংশ্লিষ্ট ডেটা সোর্সের সমস্ত বর্তমান এবং ভবিষ্যতের কলামগুলিকে ডেটা সোর্স টেবিলের সাথে সিঙ্ক করুন।
wait For Completion(timeoutInSeconds) Data Execution Status বর্তমান এক্সিকিউশন সম্পূর্ণ না হওয়া পর্যন্ত অপেক্ষা করে, প্রদত্ত সেকেন্ডের পরে টাইমিং আউট হয়।

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

add Columns(columnNames)

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

পরামিতি

নাম আদর্শ বিবরণ
column Names String[] যোগ করার জন্য কলামগুলির নামের তালিকা।

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

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

অনুমোদন

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

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

add Filter(columnName, filterCriteria)

ডেটা সোর্স টেবিলে প্রয়োগ করা একটি ফিল্টার যোগ করে।

পরামিতি

নাম আদর্শ বিবরণ
column Name String এই ফিল্টারটি যে কলামে প্রয়োগ করতে হবে তার নাম।
filter Criteria Filter Criteria প্রয়োগ করার জন্য ফিল্টারের মানদণ্ড।

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

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

অনুমোদন

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

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

add Sort Spec(columnName, ascending)

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

পরামিতি

নাম আদর্শ বিবরণ
column Name String সাজানোর জন্য কলামের নাম।
ascending Boolean যদি true , তাহলে কলামটি ঊর্ধ্বক্রম অনুসারে সাজান; যদি false , তাহলে কলামটি অবরোহক্রমে সাজান।

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

Data Source Table — চেইনিংয়ের জন্য ডেটা সোর্স শিট।

অনুমোদন

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

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

add Sort Spec(columnName, sortOrder)

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

পরামিতি

নাম আদর্শ বিবরণ
column Name String সাজানোর জন্য কলামের নাম।
sort Order Sort Order সাজানোর ক্রম।

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

Data Source Table — চেইনিংয়ের জন্য ডেটা সোর্স শিট।

অনুমোদন

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

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

cancel Data Refresh()

এই অবজেক্টটি বর্তমানে চলমান থাকলে এর সাথে সম্পর্কিত ডেটা রিফ্রেশ বাতিল করে।

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

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

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

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

Data Source Table — ডেটা অবজেক্ট।

অনুমোদন

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

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

force Refresh Data()

বর্তমান অবস্থা নির্বিশেষে এই অবজেক্টের ডেটা রিফ্রেশ করে। আরও বিস্তারিত জানার জন্য refresh Data() দেখুন। আপনি যদি এই অবজেক্টের বর্তমানে চলমান রিফ্রেশ বাতিল করতে চান, তাহলে cancel Data Refresh() দেখুন।

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

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

Data Source Table — ডেটা অবজেক্ট।

অনুমোদন

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

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

get Columns()

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

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

Data Source Table Column[] — ডেটা সোর্স টেবিল কলামের একটি তালিকা।

অনুমোদন

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

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

get Data Source()

বস্তুটি যে ডেটা সোর্সের সাথে সংযুক্ত তা পায়।

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

Data Source — তথ্য উৎস।

অনুমোদন

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

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

get Filters()

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

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

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

অনুমোদন

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

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

get Range()

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

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

Range — পরিসর।

অনুমোদন

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

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

get Row Limit()

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

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

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

অনুমোদন

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

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

get Sort Specs()

ডেটা সোর্স টেবিলের সমস্ত ধরণের স্পেসিফিকেশন পায়।

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

Sort Spec[] — Sort Specs এর একটি তালিকা।

অনুমোদন

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

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

get Status()

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

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

Data Execution Status — ডেটা এক্সিকিউশন স্ট্যাটাস।

অনুমোদন

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

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

is Syncing All Columns()

ডেটা সোর্স টেবিলটি সংশ্লিষ্ট ডেটা সোর্সের সমস্ত কলাম সিঙ্ক করছে কিনা তা ফেরত পাঠায়।

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

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

অনুমোদন

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

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

refresh Data()

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

যদি বর্তমানে error অবস্থায় থাকে তাহলে একটি ব্যতিক্রম প্রদান করে। স্পেসিফিকেশন আপডেট করতে Data Source#updateSpec() ব্যবহার করুন। ডেটা সোর্সে অপ্রত্যাশিত সম্পাদনা প্রতিরোধ করার জন্য force Refresh Data() এর চেয়ে এই পদ্ধতিটি বেশি পছন্দনীয়।

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

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

Data Source Table — ডেটা অবজেক্ট।

অনুমোদন

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

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

remove All Columns()

ডেটা সোর্স টেবিলের সকল কলাম মুছে ফেলে।

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

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

অনুমোদন

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

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

remove All Sort Specs()

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

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

Data Source Table — চেইনিংয়ের জন্য ডেটা সোর্স শিট।

অনুমোদন

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

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

set Row Limit(rowLimit)

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

পরামিতি

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

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

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

অনুমোদন

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

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

sync All Columns()

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

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

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

অনুমোদন

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

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

wait For Completion(timeoutInSeconds)

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

পরামিতি

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

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

Data Execution Status — ডেটা এক্সিকিউশন স্ট্যাটাস।

অনুমোদন

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

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