例外処理

例外は API または CData Excel Add-In for Salesforce のいずれかから発生します。各例外にはエラーコード、エラーメッセージ、および SQL ステートが含まれます。

エラーコード

エラーコードはエラーの種類を分類します。


0	NONE	未分類のエラーおよび内部処理済みエラーに使用します。このコードは、特定のカテゴリに当てはまらないデータソース固有のエラーにも対応します。
65537	TCP_UNKNOWN_HOST	ホスト名を解決できません（DNS エラー）。
65538	TCP_CONNECTION_REFUSED	リモートポートに接続できませんでした。
65539	TCP_AUTH_FAILED	バイナリ認証プロトコル使用時のログインに失敗しました。プロトコルが HTTP でない場合（LDAP、SASL、Kerberos など）の認証エラーに使用します。
65540	TCP_TIMEOUT	サーバーへのリクエスト送信後、応答を受信できませんでした。
65541	TCP_PROTOCOL	ワイヤープロトコルドライバー用。サーバーが処理できない不正なパケットを送信したか、送信するパケットを構築できません。
131073	TLS_SERVER_UNTRUSTED	SSL サーバー証明書を検証できませんでした。
131074	TLS_CLIENT_UNTRUSTED	サーバーが送信したクライアント証明書を受け入れませんでした。
196609	OAUTH_DECRYPT_FAILED	OAuthEncryptKey が OAuthSettings ファイルを復号できませんでした。
196610	OAUTH_MISSING_CLIENT_INFO	OAuthClientId / OAuthClientSecret / OAuthJWTCert が指定されていません。
196611	OAUTH_MISSING_PROP	OAuth プロパティが指定されていません。クライアント ID / シークレットおよび JWT 証明書が不足している場合は OAUTH_MISSING_CLIENT_INFO を使用します。
196612	OAUTH_NO_ACCESS_TOKEN	アクセストークンを取得できません。GetOAuthAccessToken / RefreshOAuthAccessToken でトークンを取得するときのみ使用します。
196613	OAUTH_TOKEN_EXPIRED	アクセストークンの有効期限が切れました。通常は RefreshOAuth / OAuthException の動作と組み合わせて使用します。
196614	OAUTH_INVALID_PROP	OAuth プロパティに無効な値が設定されています。値が未設定の場合は OAUTH_MISSING_CLIENT_INFO / OAUTH_MISSING_PROP を使用します。
262145	HTTP_REQUEST_TIMEOUT	HTTP サーバーから応答を受信できませんでした。
262146	HTTP_CLIENT_ERROR	HTTP 4xx エラー（汎用）。他のコードでカバーされない 4xx エラーにのみ使用します。
262147	HTTP_AUTH_FAILED	HTTP 401 エラー。
262148	HTTP_LIMIT_EXCEEDED	HTTP 429 エラー。
262149	HTTP_SERVER_ERROR	HTTP 5xx エラー。
262150	HTTP_NOT_FOUND_ERROR	HTTP 404 エラー。
327681	CORE_TIMEOUT	汎用タイムアウト。特定のネットワークリクエストとは無関係です。
327682	CORE_OP_NOT_ALLOWED	プロバイダーのアクセス許可によって操作がブロックされました。
327683	CORE_CONNECTION_CONFIG	接続設定が有効ではありません。
327684	CORE_SERIALIZE	特定のフォーマット（XML、JSON、CSV など）へのデータのエンコードに失敗しました。
327685	CORE_DESERIALIZE	特定のフォーマット（XML、JSON、CSV など）からのデータのデコードに失敗しました。
393217	SQL_SYNTAX_ERROR	SQL クエリを解析できません。
393218	SQL_MISSING_COLUMNS	クエリに必要な列が含まれていません。
393219	SQL_MISSING_PARAMS	ストアドプロシージャの呼び出しに必要なパラメーターが含まれていません。
393220	SQL_QUERY_NOT_SUPPORTED	クエリの一部が現在のコンテキストでは使用できません。
458753	SSH_SERVER_UNTRUSTED	SSH サーバーを検証できませんでした。
524289	STORAGE_LIST_EXCEPTION	ストレージリソースの一覧取得中に問題が発生しました。
524290	STORAGE_RESOURCE_NOT_FOUND	ストレージリソースの検索中に問題が発生しました。
524291	STORAGE_ROOT_RESOURCE_NOT_FOUND	ルートリソース（バケット / 共有 / ドライブ）が見つかりませんでした。フラットファイルドライバーでは作成できません。
524292	STORAGE_RESOURCE_NOT_A_DIRECTORY	ストレージリソースはディレクトリではありません。
524293	STORAGE_RESOURCE_NOT_A_FILE	ストレージリソースはファイルではありません。
524294	STORAGE_PERMISSIONS_DENIED	ストレージのアクセス権限が拒否されました。

SQL ステート

SQL ステートは汎用プロバイダーエラーをラッパーにスローする際に使用され、呼び出しの成否を示します。

一般的な SQL ステートの一部を以下に示します。


07007	REQUIRED_CLAUSE	クラスコード 07: 動的 SQL エラー。
08001	OPEN_CONNECTION	クラスコード 08: 接続例外。アプリケーションサーバーまたは他のサーバーへの接続を確立できませんでした。
08004	REJECT_CONNECTION	アプリケーションサーバーが接続の確立を拒否しました。
42501	PRIVILEGE_IDENTIFIED_OBJECT	クラスコード 42: 構文エラーまたはアクセスルール違反。指定されたオブジェクトに対して指定された操作を実行する権限が認証 ID にありません。
42506	AUTH_FAILED	所有者の認証に失敗しました。
42601	SQL_SYNTAX	文字、トークン、または句が無効か不足しています。

エラーメッセージ

エラーメッセージは、エラーが発生した理由についての詳細な情報を提供します。問題の説明と、場合によっては解決手順が含まれます。