Catalog - Preview Table Partition

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

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

GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions/{partitionName}/previewrows?api-version=2016-11-01
With optional parameters: 
GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions/{partitionName}/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 partition.
partitionName
 path True

string

Nom de la partition de table.
schemaName
 path True

string

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

string

Nom de la table contenant la partition.
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 partition.

Réponses

Nom Type Description
200 OK

USqlTablePreview

Les lignes d’aperçu de la partition spécifiée ont été récupérées.

Exemples

Retrieves a preview set of rows in given partition

Sample Request

GET https://contosoadla.azuredatalakeanalytics.net/catalog/usql/databases/master/schemas/dbo/tables/test_table_name/partitions/test_partition_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 Data Lake Analytics catalogue.
USqlTablePreview

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

USqlTableColumn

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

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 d’aperçu des lignes 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înes représentant les valeurs de la ligne. Remarque : Les tableaux d’octets apparaissent sous forme de valeurs encodées en base 64, les objets SqlMap et SqlArray 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 aux attentes 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 volumineux.