# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure DataLakeAnalyticsCatalogManagementClient…
  version: 1.0.0
extends: openapi/microsoft-azure-catalog-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 30
- target: $.paths['/catalog/usql/databases/{databaseName}/secrets/{secretName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL database secret
      effect: read
      questions:
      - How do I look up a secret stored in a U-SQL database in the Data Lake Analytics catalog?
      - Can I check which URI a named database secret points to?
      instructions:
      - text: Show me secret {secretName} in U-SQL database {databaseName}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
      - text: Fetch the details of catalog secret {secretName} from database {databaseName}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/secrets/{secretName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a secret for an external data source
      effect: write
      questions:
      - How do I store a password as a secret in a U-SQL database for an external data source?
      - Can a new database secret include the URI of the data source it connects to?
      instructions:
      - text: Create secret {secretName} in U-SQL database {databaseName} with password {password}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
          password: requestBody.password
      - text: Add a new secret {secretName} to database {databaseName} using password {password} for data source {uri}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
          password: requestBody.password
          uri: requestBody.uri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/secrets/{secretName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one secret from a U-SQL database
      effect: destructive
      questions:
      - What happens when I delete a single secret from a U-SQL database?
      - Can I remove just one named secret and keep the others in the database?
      instructions:
      - text: Delete secret {secretName} from U-SQL database {databaseName}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
      - text: Remove only the secret {secretName} in database {databaseName}, leaving the rest.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/secrets/{secretName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change an existing U-SQL database secret
      effect: write
      questions:
      - How do I rotate the password on a secret that already exists in a U-SQL database?
      - Can I point an existing database secret at a different data source URI?
      instructions:
      - text: Change the password of existing secret {secretName} in database {databaseName} to {password}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
          password: requestBody.password
      - text: Update existing secret {secretName} in database {databaseName} with password {password} and URI {uri}.
        slots:
          secretName: path.secretName
          databaseName: path.databaseName
          password: requestBody.password
          uri: requestBody.uri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/secrets'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete every secret in a U-SQL database
      effect: destructive
      questions:
      - Is there a way to wipe all secrets from a U-SQL database in one call?
      - What gets removed when I clear every secret from a Data Lake Analytics database?
      instructions:
      - text: Delete all secrets in U-SQL database {databaseName}.
        slots:
          databaseName: path.databaseName
      - text: Clear out every stored secret from database {databaseName} at once.
        slots:
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/externaldatasources/{externalDataSourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an external data source definition
      effect: read
      questions:
      - How can I see how one external data source is defined in a U-SQL database?
      - What details does the catalog return for a single external data source?
      instructions:
      - text: Show external data source {externalDataSourceName} in database {databaseName}.
        slots:
          externalDataSourceName: path.externalDataSourceName
          databaseName: path.databaseName
      - text: Get the definition of external data source {externalDataSourceName} from database {databaseName}.
        slots:
          externalDataSourceName: path.externalDataSourceName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/externaldatasources'].get
  update:
    x-apievangelist-phrasing:
      intent: List external data sources in a database
      effect: read
      questions:
      - Which external data sources are registered in my U-SQL database?
      - Can I filter or page through the external data sources in a database?
      instructions:
      - text: List the external data sources in U-SQL database {databaseName}.
        slots:
          databaseName: path.databaseName
      - text: List external data sources in database {databaseName} matching {filter}, first {top} only.
        slots:
          databaseName: path.databaseName
          filter: query.$filter
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/credentials/{credentialName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL catalog credential
      effect: read
      questions:
      - How do I inspect a single credential stored in a U-SQL database?
      - What does the catalog return about one named credential?
      instructions:
      - text: Show credential {credentialName} in U-SQL database {databaseName}.
        slots:
          credentialName: path.credentialName
          databaseName: path.databaseName
      - text: Fetch catalog credential {credentialName} from database {databaseName}.
        slots:
          credentialName: path.credentialName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/credentials'].get
  update:
    x-apievangelist-phrasing:
      intent: List credentials in a U-SQL database
      effect: read
      questions:
      - Which credentials exist in my U-SQL database?
      - Can I sort or count the credentials the Data Lake Analytics catalog holds for a database?
      instructions:
      - text: List all credentials in U-SQL database {databaseName}.
        slots:
          databaseName: path.databaseName
      - text: List credentials in database {databaseName} ordered by {orderby}.
        slots:
          databaseName: path.databaseName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/procedures/{procedureName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL stored procedure
      effect: read
      questions:
      - How do I see the definition of one stored procedure in a U-SQL schema?
      - Can I retrieve a single procedure's details from the catalog by name?
      instructions:
      - text: Show procedure {procedureName} in schema {schemaName} of database {databaseName}.
        slots:
          procedureName: path.procedureName
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: Get the stored procedure {procedureName} from {databaseName}.{schemaName}.
        slots:
          procedureName: path.procedureName
          databaseName: path.databaseName
          schemaName: path.schemaName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/procedures'].get
  update:
    x-apievangelist-phrasing:
      intent: List stored procedures in a U-SQL schema
      effect: read
      questions:
      - What stored procedures are defined in a given U-SQL schema?
      - Can I page through procedures in a schema with skip and top?
      instructions:
      - text: List the procedures in schema {schemaName} of database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List stored procedures in {databaseName}.{schemaName} matching {filter}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL table definition
      effect: read
      questions:
      - How do I get the columns and details of one U-SQL table?
      - What does the catalog tell me about a single table in a schema?
      instructions:
      - text: Show table {tableName} in schema {schemaName} of database {databaseName}.
        slots:
          tableName: path.tableName
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: Get the definition of table {tableName} from {databaseName}.{schemaName}.
        slots:
          tableName: path.tableName
          databaseName: path.databaseName
          schemaName: path.schemaName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables'].get
  update:
    x-apievangelist-phrasing:
      intent: List tables in a U-SQL schema
      effect: read
      questions:
      - Which tables live in a U-SQL schema?
      - Can I list only the tables whose names match a filter in one schema?
      instructions:
      - text: List the tables in schema {schemaName} of database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List tables in {databaseName}.{schemaName} matching {filter}, top {top}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          filter: query.$filter
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tabletypes/{tableTypeName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL table type
      effect: read
      questions:
      - How can I look up one user-defined table type in a U-SQL schema?
      - What columns does a named table type define?
      instructions:
      - text: Describe the user-defined table type {tableTypeName} under {databaseName}.{schemaName}.
        slots:
          tableTypeName: path.tableTypeName
          databaseName: path.databaseName
          schemaName: path.schemaName
      - text: Get table type {tableTypeName} from {databaseName}.{schemaName}.
        slots:
          tableTypeName: path.tableTypeName
          databaseName: path.databaseName
          schemaName: path.schemaName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tabletypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List table types in a U-SQL schema
      effect: read
      questions:
      - Which table types are defined in a U-SQL schema?
      - Can I count how many table types a schema has?
      instructions:
      - text: List the table types in schema {schemaName} of database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List table types in {databaseName}.{schemaName} matching {filter}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/views/{viewName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL view
      effect: read
      questions:
      - How do I read the definition of one view in a U-SQL schema?
      - Can I get a single catalog view by name?
      instructions:
      - text: Show view {viewName} in schema {schemaName} of database {databaseName}.
        slots:
          viewName: path.viewName
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: Get the U-SQL view {viewName} from {databaseName}.{schemaName}.
        slots:
          viewName: path.viewName
          databaseName: path.databaseName
          schemaName: path.schemaName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/views'].get
  update:
    x-apievangelist-phrasing:
      intent: List views in a U-SQL schema
      effect: read
      questions:
      - What views exist in a U-SQL schema?
      - Can I filter the list of views in a schema by name?
      instructions:
      - text: List the views in schema {schemaName} of database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List views in {databaseName}.{schemaName} matching {filter}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/statistics/{statisticsName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one statistics object on a table
      effect: read
      questions:
      - How do I inspect a specific statistics object built on a U-SQL table?
      - What does a single table statistic record contain?
      instructions:
      - text: Show statistics {statisticsName} on table {tableName} in {databaseName}.{schemaName}.
        slots:
          statisticsName: path.statisticsName
          tableName: path.tableName
          databaseName: path.databaseName
          schemaName: path.schemaName
      - text: Get table statistic {statisticsName} for {databaseName}.{schemaName}.{tableName}.
        slots:
          statisticsName: path.statisticsName
          databaseName: path.databaseName
          schemaName: path.schemaName
          tableName: path.tableName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: List statistics on a U-SQL table
      effect: read
      questions:
      - Which statistics objects have been created on a U-SQL table?
      - Can I page through all statistics defined for one table?
      instructions:
      - text: List the statistics on table {tableName} in schema {schemaName} of database {databaseName}.
        slots:
          tableName: path.tableName
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List table statistics for {databaseName}.{schemaName}.{tableName} matching {filter}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          tableName: path.tableName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions/{partitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one partition of a U-SQL table
      effect: read
      questions:
      - How do I look up a single partition of a partitioned U-SQL table?
      - What details does the catalog return for one table partition?
      instructions:
      - text: Show partition {partitionName} of table {tableName} in {databaseName}.{schemaName}.
        slots:
          partitionName: path.partitionName
          tableName: path.tableName
          databaseName: path.databaseName
          schemaName: path.schemaName
      - text: Get table partition {partitionName} for {databaseName}.{schemaName}.{tableName}.
        slots:
          partitionName: path.partitionName
          databaseName: path.databaseName
          schemaName: path.schemaName
          tableName: path.tableName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List partitions of a U-SQL table
      effect: read
      questions:
      - How many partitions does my U-SQL table have?
      - Can I list the partitions of one table with paging?
      instructions:
      - text: List the partitions of table {tableName} in schema {schemaName} of database {databaseName}.
        slots:
          tableName: path.tableName
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List partitions of {databaseName}.{schemaName}.{tableName}, first {top}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          tableName: path.tableName
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/types'].get
  update:
    x-apievangelist-phrasing:
      intent: List types in a U-SQL schema
      effect: read
      questions:
      - Which data types are available within a U-SQL database schema?
      - Can I filter the types listed for a schema?
      instructions:
      - text: List every data type available in U-SQL schema {schemaName}, database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List catalog types in {databaseName}.{schemaName} matching {filter}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tablevaluedfunctions/{tableValuedFunctionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL table-valued function
      effect: read
      questions:
      - How do I see the definition of one table-valued function in a U-SQL schema?
      - Can I retrieve a single TVF from the catalog by name?
      instructions:
      - text: Show table-valued function {tableValuedFunctionName} in {databaseName}.{schemaName}.
        slots:
          tableValuedFunctionName: path.tableValuedFunctionName
          databaseName: path.databaseName
          schemaName: path.schemaName
      - text: Get TVF {tableValuedFunctionName} from schema {schemaName} of database {databaseName}.
        slots:
          tableValuedFunctionName: path.tableValuedFunctionName
          schemaName: path.schemaName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tablevaluedfunctions'].get
  update:
    x-apievangelist-phrasing:
      intent: List table-valued functions in a schema
      effect: read
      questions:
      - What table-valued functions are defined in a U-SQL schema?
      - Can I sort the table-valued functions in a schema?
      instructions:
      - text: List the table-valued functions in schema {schemaName} of database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: List TVFs in {databaseName}.{schemaName} ordered by {orderby}.
        slots:
          databaseName: path.databaseName
          schemaName: path.schemaName
          orderby: query.$orderby
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/assemblies/{assemblyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL assembly
      effect: read
      questions:
      - How do I look up a registered assembly in a U-SQL database?
      - What does the catalog return about one assembly, like its files and dependencies?
      instructions:
      - text: Show assembly {assemblyName} in U-SQL database {databaseName}.
        slots:
          assemblyName: path.assemblyName
          databaseName: path.databaseName
      - text: Get the registered assembly {assemblyName} from database {databaseName}.
        slots:
          assemblyName: path.assemblyName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/assemblies'].get
  update:
    x-apievangelist-phrasing:
      intent: List assemblies in a U-SQL database
      effect: read
      questions:
      - Which assemblies are registered in my U-SQL database?
      - Can I page through the assemblies in a database?
      instructions:
      - text: List the assemblies in U-SQL database {databaseName}.
        slots:
          databaseName: path.databaseName
      - text: List assemblies in database {databaseName} matching {filter}.
        slots:
          databaseName: path.databaseName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas/{schemaName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL schema
      effect: read
      questions:
      - How do I get the details of one schema in a U-SQL database?
      - Can I fetch a single schema from the catalog by name?
      instructions:
      - text: Show schema {schemaName} in U-SQL database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      - text: Get catalog schema {schemaName} from database {databaseName}.
        slots:
          schemaName: path.schemaName
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}/schemas'].get
  update:
    x-apievangelist-phrasing:
      intent: List schemas in a U-SQL database
      effect: read
      questions:
      - What schemas does my U-SQL database contain?
      - Can I filter the schemas returned for a database?
      instructions:
      - text: List the schemas in U-SQL database {databaseName}.
        slots:
          databaseName: path.databaseName
      - text: List schemas in database {databaseName} matching {filter}.
        slots:
          databaseName: path.databaseName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases/{databaseName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a U-SQL database
      effect: read
      questions:
      - How do I get the details of one database in the Data Lake Analytics catalog?
      - Can I look up a single U-SQL database by name?
      instructions:
      - text: Show U-SQL database {databaseName}.
        slots:
          databaseName: path.databaseName
      - text: Get the catalog entry for database {databaseName}.
        slots:
          databaseName: path.databaseName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/catalog/usql/databases'].get
  update:
    x-apievangelist-phrasing:
      intent: List U-SQL databases in the catalog
      effect: read
      questions:
      - Which U-SQL databases exist in my Data Lake Analytics account?
      - Can I count or filter all the databases in the catalog?
      instructions:
      - text: List all U-SQL databases in the catalog.
      - text: List catalog databases matching {filter}, top {top}.
        slots:
          filter: query.$filter
          top: query.$top
      method: generated
      generated: '2026-09-26'