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 ডেটা উৎস টেবিলের জন্য সারি সীমা প্রদান করে।
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 পত্রক UI এর মতো ডিফল্ট সর্বোচ্চ সীমা ব্যবহার করে।

অনুমোদন

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

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

get Sort Specs()

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

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

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

অনুমোদন

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

  • 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 পত্রক 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