বিদ্যমান ডেটা সোর্স টেবিল অ্যাক্সেস এবং পরিবর্তন করুন। একটি নতুন শীটে একটি নতুন ডেটা সোর্স টেবিল তৈরি করতে, 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()
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