注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Smartsheet
Smartsheet コネクターは、Smartsheet 用の Palantir 提供のドライバーです。
新しい Smartsheet ソースを作成するには、Palantir 提供のドライバーの標準セットアップフローに沿って進め、以下のセクションで Smartsheet 固有の設定とネットワーク設定を行います。プロパティの完全なリファレンスについては、Smartsheet ドライバーの公式ドキュメント ↗を参照してください。
サポートされる機能
| 機能 | ステータス |
|---|---|
| 探索 | 🟢 一般提供 |
| バッチ同期 | 🟢 一般提供 |
| インクリメンタル（差分連携） | 🟢 一般提供 |
| OAuth 2.0 認証 | 🟢 一般提供 |
| テーブルエクスポート | 🟢 一般提供 |
設定
以下のプロパティは必須または推奨です。
| プロパティ | 必須かどうか | 説明 | デフォルト |
|---|---|---|---|
UseLegacyAPI ↗ | 必須 | テーブルのメタデータ（および一部の列のメタデータ）の検出に使用する API を決定します。 | FALSE |
AuthScheme ↗ | 推奨 | Smartsheet への接続時に使用する認証方式を指定します。 | PersonalAccessToken |
InitiateOAuth ↗ | 推奨 | OAuth アクセストークンを取得または更新するプロセスを指定します。このトークンは、認証および認可されたユーザーが作業している間、ユーザーのアクセスを維持します。 | REFRESH |
OAuthClientId ↗ | 推奨 | カスタム OAuth アプリケーションに割り当てられたクライアントID（コンシューマー鍵とも呼ばれます）を指定します。この ID は、認証時に OAuth 認可サーバーがアプリケーションを識別するために必要です。 | — |
OAuthClientSecret ↗ | 推奨 | カスタム OAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密値は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタム OAuth アプリケーションのみ。） | — |
PersonalAccessToken ↗ | 推奨 | Smartsheet での認証に使用する個人用アクセストークンを指定します。このトークンは Smartsheet のユーザーインターフェースから生成できます。 | — |
Region ↗ | 推奨 | Smartsheet アカウントのホスティングリージョンを指定します。 | GLOBAL |
ネットワーク
以下のテーブルは、ソースの実行に必要なアクセス先ドメインを示しています。
各ドメインに対応するエグレスポリシーを追加します。ソースがオンプレミスでホストされ、Foundry から直接アクセスできない場合は、代わりに Agent プロキシのエグレスポリシーを使用します。Agent ホスト自体も、記載されたドメインにアクセスできる必要があります。詳細については、Agent をプロキシとして使用するを参照してください。
| ドメイン | 必須条件 |
|---|---|
| api.smartsheet.com | Region=GLOBAL の場合（デフォルト） |
| api.smartsheet.eu | Region=EU の場合 |
| api.smartsheetgov.com | Region=GOV の場合 |
| app.smartsheet.com | 認可 URL にのみ必要、Region=GLOBAL の場合（デフォルト） |
| app.smartsheet.eu | 認可 URL にのみ必要、Region=EU の場合 |
| app.smartsheetgov.com | 認可 URL にのみ必要、Region=GOV の場合 |
OAuth 2.0 認証
このコネクターは OAuth 2.0 認証をサポートしています。Palantir 提供のドライバー向け OAuth 2.0 ガイドに沿って、接続の設定と認可を行います。
テーブルエクスポート
このコネクターはテーブルエクスポートをサポートしています。テーブルエクスポートをセットアップする方法をご覧ください。
接続設定
URL 項目は変更できず、jdbc:smartsheet: に固定されています。JDBC URL を変更する代わりに、JDBC プロパティセクションを使用できます。
たとえば、次の JDBC URL を表すには、
jdbc:smartsheet:InitiateOAuth=GETANDREFRESH;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;、JDBC プロパティセクションで追加のプロパティを次のように指定できます。
