テーブルのメタデータの記述

説明

リポジトリ内の名前付きテーブルのメタデータを返します。レスポンス内の情報には、テーブルの座標参照系、境界ボックス、列、列のタイプ、geohash インデックスの詳細情報 (縮尺と精度) が含まれます。バインド パラメータがある場合は、それらも含まれています。

注: ラスタを参照している名前付きテーブルの場合、名前付きテーブルのメタデータ記述操作はラスタの幅と高さを返します。MRR の場合は、フィールドとバンドの詳細も表示されます。このページの「ラスタ」セクションを参照してください。

ACL 認証フロー

リポジトリ内の単一の名前付きテーブルのメタデータを返すには、ユーザ (またはユーザが属する役割) に名前付きテーブルに対する EXECUTE 権限が必要です。

HTTP GET URL 形式

HTTP GET リクエストには次の形式を使用します。

HTTP GET /tables/tablename/metadata.rep

パラメータ

以下のパラメータのタイプについては、リクエスト URL のデータ タイプを参照してください。

パラメータ タイプ 必須 説明
tablename 文字列 はい メタデータを記述する必要があるテーブルの名前を指定します。テーブルは、リポジトリ内の名前付きテーブルの場所に基づいて、レンダリングする名前付きテーブルの正規表現 (Regex) で指定します。名前付きテーブルの名前は、URL の /tables 部と URL の /metadata.rep 部の間で定義します。例えば、リポジトリ内の /Samples/NamedTables/WorldTable にある名前付きテーブルのメタデータを返すには、次のような URL を使用します。
.../FeatureService/tables/Samples/NamedTables
/WorldTable/metadata.json;...
rep 文字列 はい 戻り値の表現を指定します。サポートされている表現は json です。

戻り値

リポジトリ内の名前付きテーブルのメタデータを返します。

リポジトリ内の /Samples/NamedTables ディレクトリにあるテーブル WorldMap のメタデータを返します。

POST http://hostname:port/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldTable/
metadata.json

例: ラスタ

ラスタを参照している名前付きテーブルの場合、名前付きテーブルのメタデータ記述操作はラスタ固有の情報を返します。

要求

POST http://hostname:port/rest/Spatial/FeatureService/tables/Samples/NamedTables/MRRWorldTable/
metadata.json

応答

{
   "Metadata":[
      {
         "name":"MI_RASTER",
         "type":"Raster",
         "crs":{
            "type":"name",
            "properties":{
               "name":"epsg:3395"
            }
         },
         "bbox":[
            -70.0,
            -173.46657488287798,
            186.0,
            82.53342511712202
         ]
      },
      {
         "name":"MI_Style",
         "type":"Style"
      }
   ],
   "TableMetadata":{
      "supportsInsert":false,
      "supportsDelete":false,
      "supportsUpdate":false,
      "KeyDefinition":{
         "type":"Implicit",
         "attributes":[
            "MapInfo_ID"
         ]
      },
      "rasterMetadata":{
         "width":128,
         "height":128,
         "supportsGridCellValue":true,
         "fields":[
            {
               "name":"Field0",
               "type":"Imagery",
               "bands":[
                  {
                     "name":"Band00",
                     "type":"Concrete",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"RED",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"GREEN",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"BLUE",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  }
               ]
            },
            {
               "name":"Field1",
               "type":"Imagery",
               "bands":[
                  {
                     "name":"Band00",
                     "type":"Concrete",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"RED",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"GREEN",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"BLUE",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  }
               ]
            },
            {
               "name":"Field2",
               "type":"Imagery",
               "bands":[
                  {
                     "name":"Band00",
                     "type":"Concrete",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"RED",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"GREEN",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  },
                  {
                     "name":"BLUE",
                     "type":"Component",
                     "dataType":"Integer",
                     "mapInfoUnits":"Undefined"
                  }
               ]
            }
         ]
      }
   }
}

この応答には、“rasterMetadata” の下に追加のラスタ サイズ、フィールド、およびバンドの詳細が含まれます。次の表は、応答で使われる各フィールドについての説明です。

パラメータ 説明
rasterMetadata ラスタのサイズ、フィールド、およびバンドの詳細に関するラスタのメタデータを指定します。
width ラスタの幅をピクセル単位で示します。
height ラスタの高さをピクセル単位で示します。
supportsGridCellValue ラスタがグリッド セル値をサポートするかどうかを示します。
フィールド フィールドを配列オブジェクトとして指定します。各フィールド オブジェクトには、名前、タイプ、およびオブジェクト内のバンドが含まれます。MRR にのみ適用されます。
名前 フィールドの名前を示します。
type MapInfo Pro Advanced でサポートされるフィールドのタイプを指定します。フィールドには次の 4 つのタイプがあります。
  1. 分類済み
  2. 連続
  3. イメージ
  4. イメージ パレット
bands MRR フィールド内のバンドを配列として指定します。バンド オブジェクトには、名前、タイプ、データ タイプ、および mapinfoUnits が含まれます。
名前 バンドの名前を示します。
type ラスタ バンド値のソースを示します。バンド タイプには次のタイプがあります。
  1. Concrete: バンド データはラスタ データセットに格納されます。
  2. Component: バンド データは別の実体バンドの取得済みコンポーネントです。
  3. Table Field: バンド データは分類テーブル フィールドから取得されます。
  4. Table Field Component: バンド データは、分類テーブル フィールドから取得された別のバンドの取得コンポーネントです。
dataType バンドのデータ タイプを指定します。Byte、Short、Integer、Long、BigInteger、Double、String などのデータ タイプがあります。
mapInfoUnits MapInfo の単位を定義します。マイル、メートル、チェーン、海里、度、分角などの単位があります。

例: パラメータ化されたビュー テーブルのメタデータ

この例では、バインド パラメータを含むビュー テーブル (パラメータ化されたビュー テーブル) を使用します。

要求

POST http://hostname:port/rest/Spatial/FeatureService/tables/NamedTables/ViewTableWithParameters/metadata.json

応答

{
	"Metadata": [
		{
			"name": "World.Obj",
			"type": "Geometry",
			"bbox": [
				-182.79333499999998,
				-90,
				180,
				83.62735699999999
			],
			"styleColumn": "MI_Style"
		},
		{
			"name": "WorldCap.Country",
			"type": "String"
		}
	],
	"TableMetadata": {
		"supportsInsert": false,
		"supportsDelete": false,
		"supportsUpdate": false,
		"KeyDefinition": {
			"type": "None",
			"attributes": []
		},
		"parameters": [
			{
				"name": "param",
				"description": "List of Countries",
				"value": [
					"Canada",
					"United States"
				],
				"type": "STRING"
			}
		],
		"referencedTables": [
			"/Samples/NamedTables/WorldTable" 
		]
	}
}

この応答には、名前付きビュー テーブルに定義されているバインド パラメータのリストが含まれています。SQL クエリで使用されているすべての名前付きテーブルも含まれています。結合クエリでは、結合で使用されるすべての名前付きテーブルが referencedTables に含まれます。