Catalog - Preview Table

  • Référence
Service:
Data Lake Analytics
API Version:
2016-11-01

Récupère un jeu de lignes en préversion dans une table donnée.

GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/previewrows?api-version=2016-11-01
With optional parameters: 
GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/previewrows?maxRows={maxRows}&maxColumns={maxColumns}&api-version=2016-11-01

Paramètres URI

Nom Dans Obligatoire Type Description
accountName
 path True

string

Compte Azure Data Lake Analytics sur lequel exécuter des opérations de catalogue.
adlaCatalogDnsSuffix
 path True

string

Obtient le suffixe DNS utilisé comme base pour toutes les demandes de service Azure Data Lake Analytics Catalog.
databaseName
 path True

string

Nom de la base de données contenant la table.
schemaName
 path True

string

Nom du schéma contenant la table.
tableName
 path True

string

Nom de la table.
api-version
 query True

string

Version de l’API cliente.
maxColumns
 query

integer

int64

Nombre maximal de colonnes à récupérer.
maxRows
 query

integer

int64

Nombre maximal de lignes d’aperçu à récupérer. Les lignes retournées peuvent être inférieures ou égales à ce nombre en fonction de la taille des lignes et du nombre de lignes dans la table.

Réponses

Nom Type Description
200 OK

USqlTablePreview

Les lignes d’aperçu ont été récupérées avec succès pour la table spécifiée.

Exemples

Retrieves a preview set of rows in given table

Sample Request

GET https://contosoadla.azuredatalakeanalytics.net/catalog/usql/databases/master/schemas/dbo/tables/test_table_name/previewrows?api-version=2016-11-01

Sample Response

Status code:
200 
{
  "totalRowCount": 1,
  "totalColumnCount": 2,
  "rows": [
    [
      "value_a",
      "value_b"
    ]
  ],
  "truncated": false,
  "schema": [
    {
      "name": "test_column_name",
      "type": "test_data_type"
    }
  ]
}

Définitions

Nom Description
USqlTableColumn

Élément de colonne de table U-SQL du catalogue Data Lake Analytics.
USqlTablePreview

Un Data Lake Analytics élément de lignes d’aperçu de la table de catalogue ou de la partition.

USqlTableColumn

Élément de colonne de table U-SQL du catalogue Data Lake Analytics.

Nom Type Description
name

string

nom de la colonne dans la table.
type

string

type d’objet de la colonne spécifiée (par exemple, System.String).

USqlTablePreview

Un Data Lake Analytics élément de lignes d’aperçu de la table de catalogue ou de la partition.

Nom Type Description
rows

string[]

les lignes de l’aperçu de la table ou de la partition, où chaque ligne est un tableau de chaîne représente les valeurs de la ligne. Remarque : Les tableaux d’octets s’affichent sous forme de valeurs encodées en base 64, les objets SqlMap et SqlArray apparaissent sous forme d’objets JSON d’échappement, et les objets DateTime apparaissent en tant que date-heure UTC au format ISO.
schema

USqlTableColumn[]

schéma de la table ou de la partition.
totalColumnCount

integer

nombre total de colonnes dans la table ou la partition.
totalRowCount

integer

nombre total de lignes dans la table ou la partition.
truncated

boolean

true si la quantité de données dans la réponse est inférieure à ce qui était prévu en raison des limitations de taille de l’opération d’aperçu. Cela peut se produire si les lignes demandées ou le nombre de lignes sont trop grands.