Smartsheetコネクタのリファレンス

このページには、 LakeFlow Connectのマネージド Smartsheet コネクタに関するリファレンス ドキュメントが含まれています。

型マッピング

Smartsheetコネクタは、データ取り込み時にSmartsheetの列型をSparkの型にマッピングします。以下の表は、サポートされている各列タイプのマッピングを示しています。

Smartsheetの列タイプ	Sparkターゲットタイプ	論理／変換動作
TEXT_NUMBER	STRING	常にSTRINGにマッピングされます。
DATE	DATE	Smartsheet API から取得した ISO-8601 形式の日付文字列。
DATETIME	TIMESTAMP	Smartsheet API からの UTC タイムスタンプ。
CHECKBOX	BOOLEAN	trueをtrueに、 falseをfalseにマッピングします。
CONTACT_LIST	STRUCT<name: STRING, email: STRING>	name およびemailは、接触オブジェクトの値から抽出されます。
MULTI_CONTACT_LIST	ARRAY<STRUCT<name: STRING, email: STRING>>	リスト内の各連絡先は構造体として抽出されます。
PICKLIST （落ちる）	STRING	選択されたオプションの表示値が取り込まれます。
MULTI_PICKLIST	ARRAY<STRING>	選択された各オプションは、配列の要素として取り込まれます。
DURATION	STRING	人間が読みやすい形式（例： 3d 4h ）は文字列として保持されます。
PREDECESSOR	STRING	タスクの依存関係表現は文字列として保持されます。
AUTO_NUMBER	STRING	システムによって自動生成される、自動インクリメントされる行ラベル。読み取り専用。
ABSTRACT_DATETIME	TIMESTAMP	システム列（例：作成日時）に使用されます。UTCベース。
CREATED_DATE / MODIFIED_DATE	TIMESTAMP	作成日時などのシステム列に使用されます。UTCベース。
CREATED_BY / MODIFIED_BY	STRUCT<name: STRING, email: STRING>	行レベルの監査メタデータ。UTCベース。
公式	[派生]	評価された表示値は取り込まれ、列で宣言されたターゲット型にキャストされます。数式文字列（例： =SUM(...) ）は取り込まれません。

パイプライン構成の問題

次の表では、Smartsheet 取り込みパイプラインの構成に使用できるすべての機能を説明します。

接続の問題

パラメーター	必須	説明
connection_name	はい	Smartsheet 用のUnity Catalog接続名。

ソースの決定

パラメーター	必須	説明
source_schema	はい	常に"default" 。
source_table	はい	Smartsheetのシートまたはレポートの16桁のID。

目的地がわからない

パラメーター	必須	説明
destination_catalog	はい	ターゲットUnity Catalogカタログ。
destination_schema	はい	カタログ内の対象スキーマ。
destination_table	No	対象テーブル名。デフォルトでは、SmartsheetのシートまたはレポートIDが使用されます。

table_configuration選択肢

パラメーター	必須	デフォルト	説明
row_filter	No	すべての行	選択的に行を取り込むためのDBSQLフィルタ式。行フィルタリングを参照してください。
include_columns	No	すべての列	取り込んだテーブルに含める列名のリスト。指定されている場合は、リストされた列のみが取り込まれます。
exclude_columns	No	なし	取り込んだテーブルから除外する列名のリスト。include_columnsと併用することはできません。

connector_options

パラメーター	必須	説明
enforce_schema	No	true (デフォルト) の場合、列を Smartsheet で宣言された型にマッピングします。準拠していないセルはNULLに設定されます。falseの場合、すべての列はSTRINGとして取り込まれます。

enforce_schema動作

enforce_schemaオプションは、コネクタがデータ取り込み時に Smartsheet の列タイプを Spark のタイプにマッピングする方法を制御します。これはconnector_optionsに設定され、デフォルトはtrueです。

• enforce_schema: true (デフォルト) — 各列は、上記の型マッピング表に従って、Smartsheet で宣言された型にマッピングされます。宣言された型に準拠しないセルは、パイプラインの失敗を引き起こすのではなく、 NULLに設定されます。一貫性があり、正しく入力されたデータを含むシートには、この設定を使用してください。

• enforce_schema: false — すべての列は、宣言された Smartsheet タイプに関係なく、 STRINGとして取り込まれます。この設定は、不規則なデータを含むシート、頻繁に上書きされる列型、または下流システムが型変換を処理する場合に使用します。

  JSON

  "connector_options": {
    "enforce_schema": false
  }

行フィルタリング

シートまたはレポートから行のサブセットを取り込むには、 table_configurationのrow_filterオプションを使用します。行は、 row_number （1から始まる）または列のSmartsheetタイトルを使用した任意の列値によって参照されます。

サポートされている演算子: = 、 != 、 < 、 <= 、 > 、 >= 、 AND 、 OR 、 IN 、 BETWEEN 、 LIKE

詳細については、 「行フィルタリング」を参照してください。